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PREFACE 



This Programmer's System Bulletin explains how a user 
application program should be written to communicate with 
the network through the Network Access Method (NAM). 

Such an application program can be written in one of the 
high-level languages, such as FORTRAN, COBOL, or 
SYMPL, where communication is with the various NAM 
components through interface routines; or it can be written 
in COMPASS, where communication is provided through a 
set of macros. 

This bulletin does not contain all details concerning the use 
of NAM; however, it explains the basic principles to the 
novice user. For more detail concerning the use of NAM, 
refer to the NAM 1 reference manual. 



Examples and routine call formats are presented in 
FORTRAN, and only the interactive features are discussed. 
Shading is used on sample listings to highlight coding 
changes to an earlier example that implement additional 
features. Shading does not indicate ANSI or non-ANSI 
usages. 



RELATED MANUALS 

The NAM applications programmer can find additional 
pertinent information in the following Control Data 
Corporation manuals: 



Publication 

NOS 1 Reference Manual (Volume I) 

NOS 1 Reference Manual (Volume II) 

NOS 1 System Maintenance Reference Manual 

NOS 1 Operator's Guide 

Transaction Facility Version 1 Reference Manual 

Interactive Facility Version 1 Reference Manual 

COMPASS Version 3 Reference Manual 

FORTRAN Extended Version 4 Reference Manual 

Network Products Stimulator Version 1 
Reference Manual 

Network Products Network Access Method 
Version 1 Reference Manual 

Network Products Network Access Method 
Version 1 Network Definition Language 
Reference Manual 

Network Products Remote Batch Facility 
Version 1 Reference Manual 

Network Products 255* Series Communications 
Control Program Version 3 Reference Manual 

8-Bit Subroutines Reference Manual 

Programming Reference Aids 

731-12 Remote Batch Terminal Operating 
and Programming Guide 

200 User Terminal 

Operating and Programming Guide 

714-10/20 Remote Terminal Subsystem 
Operating Guide 

714-10/20 Remote Terminal Subsystem 
Reference Manual 



Publication Number 
60435400 
60445300 
60455380 
60435600 
60455340 
60455250 
60492600 
60497800 

60480500 

60499500 

60480000 

60499600 

60471400 
60495500 
60158600 

82186800 

82136000 

82184500 

82184600 
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711-10 CRT Display Terminal Operator's Guide 

711-10 CRT Display Terminal Reference Manual 

750 Terminal Subsystem Operator's Guide 

750 Terminal Subsystem Reference Manual 

713-10 Conversational Display Terminal 
Operator's Guide 

713-10 Conversational Display Terminal 
Reference Manual 

734 Batch Terminal Operator's Guide 

734 Batch Terminal Reference Manual 

Mode 4C Data Communication 
Control Procedure System Standard 



62034100 
62022700 
62951400 
62962800 

62037900 

62033400 
62971500 
62971300 

CDC-STD 1.10.020 



CDC manuals can be ordered from Control Data Literature and Distribution Services, 
8001 East Bloomington Freeway, Minneapolis, Minnesota 55420. 



This product is intended for use only as described in this document. 
Control Data cannot be responsible for the proper functioning of 
undescribed features or parameters. 
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INTRODUCTION 



WHAT IS NAM? 

Network Access Method (NAM) is a data message-switching 
and routing system. It enables host applications to share 
access with a network of terminals and other host 
applications. 

NAM is not only an interface between programs running in a 
host and the network, but is also an access method. NAM 
has its own unique communication protocols. Application 
programs requiring network access must be specially 
written. 

This bulletin is oriented toward application programs that 
support interactive terminals. An application to drive a 
remote batch station, which contains card readers and line 
printers, can also be written. These features, however, are 
not discussed in this bulletin. 



WHAT ARE THE BASIC 
NAM COMPONENTS? 

The basic NAM components are shown in figure 1-1. A 
description of these basic components is as fallows: 

• The Network Interface Program (NIP) - a central 
processor program running in a dedicated system 
control point. NIP can read and write into the field 
lengths of other control points. 

• The Peripheral Interface Program (PIP) - the 
NPU-NAM interface running in a dedicated peripheral 
processing unit (PPU) for the NIP control point. One or 
more copies of PIP can reside in the PPUs, depending on 
the configuration of enabled network nodes. 



WHAT DOES NETWORK MEAN? 

A network is an interconnected complex that consists of 
terminals, network processing units (NPUs), couplers, and a 
host computer (such as the CONTROL DATA® CYBER 170 
Models 171, 172, 173, 174 and 175; the CYBER 70 Models 71, 
72, 73 and 74; and the 6000 Series Computer Systems). At 
present, only one host computer is supported. Future 
networks will provide multihost configurations. 

WHY NAM IS NEEDED? 

The topology of a network can become extremely complex, 
consisting of hundreds of different terminals, NPUs, and a 
host computer. NAM is provided as an interface between 
application programs executing in the host at one end and 
the terminals connected to the network at the other end. 
NAM provides simple, concise, and unique communication 
protocols, relieving the applications programmer of concern 
for different and complex protocols needed for such data 
and message traffic. 

NAM also provides the following features: 

• Isolation of network communications from the operating 
system 

• Management of network protocol 

• Dynamic establishment, maintenance, and termination 
of data paths between terminals and programs, or 
between programs 

• Buffering and queuing of data for regulation of data 
flow 

• Support of a wide variety of terminals through 
normalization of data formats (code conversion), as well 
as the ability to handle transparent unnormalized and 
unconverted data 

• Communication of any program with a number of 
terminals, addressed individually or as members of a 
group 

• Detection of inactivity on any data path 



• The Application Interface Program (AIP) - a collection 
of relocatable subroutines residing in the field length of 
all network application programs. AIP performs access 
control and buffering functions for the application. 

• The Communications Control Program (CCP) - a 
program to drive the terminals connected to the NPUs. 
It resides in the NPUs and contains TIPs (Terminal 
Interface Programs). CCP is technically not a part of 
NAM but must be used when NAM is used. 

Other NAM components execute as application programs 
running at normal control points. The following components 
are not dedicated and can be rolled out: 



• The Network Supervisor (NS) - coordinates the 
activities of the various NPUs. NS is responsible for 
loading the software into the NPUs, and for establishing 
and controlling physical paths through the communi- 
cation network. 



The Communication Supervisor (CS) 
line-oriented and terminal-oriented 
host computer. 



- coordinates the 
activities of the 



• The Network Validation Facility (NVF) - is responsible 
for granting network access to the terminal user. 

The above components enable any user to write his own 
application. Various standard application programs provide 
a set of commonly used communications functions: 

• The Remote Batch Facility (RBF) _ supports remote 
job entry terminals, such as 200 User Terminals or 
HASP workstations. 

• The Interactive Facility (IAF) - supports interactive 
control statement processing. 

• The Transaction Access Facility (TAF) - supports 
transactional terminal operation. 

• The Terminal Verification Facility (TVF) - provides 
terminal verification tests. 
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HOW IS NAM USED? 

The main user of NAM is a programmer who writes 
installation applications. Application programs communi- 
cating with terminals, or with other application programs, 
must call the appropriate AIP routines. The AIP routines 
interface between the application and other NAM 
components. 

Access to the network must be initialized by calling the AIP 
NETON routine. After NETON has been granted by NAM, 
other AIP routines can be called. These routines enable data 



and supervisory message traffic between the application and 
the network. When an application no longer requires use of 
the network, it must call the AIP NETOFF routine, which 
causes NAM to disconnect the application from the network. 

In the following sections, some basic terms and a few 
FORTRAN-written application programs are presented. The 
programs start with a simple program showing connection- 
establishment steps. The programs are expanded later to a 
multiterminal conversation program. Parallel mode and 
application-to-application communication program examples 
are also presented. 



T-terminal 



Remote NPUs 




Figure 1-1. Network Software Relationships 
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BASIC TERMS 



Before writing our first application program, some basic 
terms are essential to further our understanding of NAM. 



THE APPLICATION CONNECTION 
NUMBER 

When data passes between a terminal and an application, a 
message path exists between the two. This message path is 
called a logical connection. After access, a terminal is 
logically connected to one application at a time. It can be 
switched from application to application as needed. Appli- 
cations can be connected simultaneously to many terminals. 

This logical connection is identified as the application 
connection number (ACN). The ACN is a 12-bit integer 
value, assigned by NAM, used to specify a particular path. 
An ACN that becomes available because of disconnections is 
reassigned to a subsequent connection. An ACN of 
indicates the control connection along which certain 
supervisory messages are sent and received. 



When the application inputs data from a specific terminal or 
another application, it calls the AIP NETGET routine, and 
specifies the ACN from which input is requested. 

When the application program outputs data to a specific 
terminal or another application, it calls the AIP NETPUT 
routine, again specifying the ACN to which output is to be 
sent. 

Notice that ACNs and connections are not the same; while 
connections are always unique at a given time, ACNs are 
unique only within the same application program. For 
example, in figure 2-1, an ACN of 2 identifies connection b 
for application A, connection e for application B, and 
connection h for. application C. 

Also notice that application-to-application connections are 
identified by two ACNs, which are not necessarily the same 
number. For example, application A is assigned an ACN of 5 
for connection g, while application C is assigned an ACN of 
1 for the same connection. 







connection b 



{ -j- V— connection < 



r 



l 





connection h 



connection e 



i— connection 



ACN=2 
|ACN=3 



ion c -( t ) 



r connection d — i 
Ari\i= 







r— connection f — 



| ACN=4 ACN=1 

I II I 



ACN=2 
ACN=1 



■—connection g 



Application 
A 



ACN=5 

L_ 



l I ACN=3 

I I I 



Application 
B 



1 



r— connection i 



ACN=2 



<D 



HOST 



ACN=1 ACN=3 
I I I , 



Application 
C 



I 



I 



Figure 2-1. Application Connection Numbers 
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THE MESSAGE 



THE TEXT AREA 



A message is a logical unit of information exchanged 
between NAM and the application. It can be a line of data, 
a screen, or a file. A message can be of arbitrary length and 
content. If long, the message is broken into smaller units 
called blocks. 



THE BLOCK 

A block is the basic unit of information exchanged between 
NAM and the application. Block length is dependent on the 
terminal device, but cannot exceed 410 60-bit words or 2043 
characters. 

There are two types of blocks involved in data transfer: 

BLK blocks - the first n-1 blocks of the message when 
a message is composed of n blocks. 

MSG block - the last or nth block of a message. See 
figure 2-2. 

A message can contain a MSG type block only when the 
message is short enough to be contained in one block. 

In addition to BLK blocks and MSG blocks, there are two 
special type blocks: 

Null blocks - blocks containing no physical informa- 
tion, but rather indicate a status. A status results when 
NAM has no input for the application input operation. 

SM blocks - supervisory message blocks. They are not 
part of a message. They convey information about the 
data and connections. Supervisory messages consist of 
one block and are used for control purposes. 



SUPERVISORY MESSAGES 

Application programs exchange supervisory messages (SM) 
with NAM to control logical connections and data flow. 
There are two types of supervisory messages: 

Asynchronous supervisory message (ASM) 

Synchronous supervisory message (SSM) 

All supervisory messages that are sent or received on an 
ACN of are asynchronous, and are exchanged independent 
of the data; conversely, supervisory messages that are sent 
or received on an ACN not equal to are synchronous, and 
are exchanged at the same time as the data. Synchronous 
supervisory messages can be used as markers in the data 
stream. All supervisory messages have a special role and 
format, and are listed in appendix C. 



The text area (ta) is a buffer used to exchange information 
between NAM and the application program. See figure 2-3. 
Text area length cannot exceed 410 central memory words, 
and can contain one of the following: 

• A BLK type block 

• A MSG type block 

• An SM type block 











Application Block Header 












Text Area 

(410 central memory words 
maximum) 









Figure 2-3. Application Block Header and Text Area 



THE APPLICATION BLOCK HEADER 

Every block or supervisory message passed between NAM 
and the application must be accompanied by one word which 
is called the application block header (ABH). See fig- 
ures 2-3 and 2-4. Each header contains detailed information 
describing the text area information it accompanies, 
indicating what NAM or the application should do with it. 

On output, the application creates the ABH and NAM 
interprets it. On input, NAM creates ABH and the 
application interprets it. The ABH and the text area can 
reside in two different areas in memory; therefore, they 
need not be contiguous. Usages of the ABH and text area 
are shown in the following examples. 

After inputting the ASCII characters 

THIS IS INPUT 

the contents of the ABH word are configured, as shown in 
figure 2-5. The contents of the text area are shown in 
figure 2-6. 




Figure 2-2. BLK and MSG Message Blocks 
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ABT 



ADR 
ABN 



ACT 



FLAGS 
TLC 



59 


53 




41 




23 


19 


11 







ABT 


ADR 


ABN 


ACT 


FLAGS 


TLC 



Application block type: 

= Null block, input only. 

1 = BLK type block, first n-1 blocks of a message. 

2 - MSG type block, which is the last block' of a message, or the only block. 

3 = Supervisory message, input or output. 
Addressing information; contains the ACN. 

Application block number; a number created by the application to keep track of transferred blocks. It can be: 

A serial number 

The block's core address 

The block's disk address 

An external name 
or whatever the application chooses appropriate to identify the block. 
Application character type. This is a number identifying the associated block character type and can be: 

1 = 60-bit words. Must be used for application-to-application connections and for supervisory messages 

when an ADR is not equal to 0. Cannot be used for application-to-terminal connections. 

2 = 8-bit ASCII characters 7.5 characters per word, used for application-to-terminal connections, and for 

synchronous supervisory messages when ADR is equal to 0. See section 2. 

3 =• 8-bit ASCII characters, right-justified in 12-bit bytes 5 per central memory word. Used as an alter- 

nate form for application to-terminal connections. Cannot be used for supervisory messages. 

4 = 6-bit display code characters, 10 per word. 

Alternate form for application-to-terminal connections. 

Cannot be used for supervisory messages. 
Various flags. Their use is explained in section 5. 
Text length in units specified by the ACT. 



Figure 2-4. Application Block Header Format 



020001 00000014000016 



- 



L 



Text Length = 14 characters 



.Character type = 3 
(ASCII, 5 characters per word) 



Connection number 1 



A MSG Block 



Figure 2-5. ABH Configuration of 'ATHISAISAINPUT' 
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Figure 2-6. Content of Text Area of 'ATHISAISAINPUT' 

Upon outputting the 18-character display code message 

ENTER INPUT PLEASE 

the contents of the ABH word are configured, as shown in 
figure 2-7. The contents of the text area are shown in 
figure 2-8. 

BASIC PROTOCOLS INVOLVING 
SUPERVISORY MESSAGES 

A protocol is the ordered step-by-step process of exchanging 
messages. An example of a supervisory message protocol is 
the pair of messages for a request for some action to be 
performed and a response to it. (either acceptance or 
rejection). As mentioned earlier, supervisory messages can 
be initiated by NAM and responded to by the application, or 
vice versa. 

Every supervisory message is identified by two function 
codes: 

Primary function code (PFC) 

Secondary function code (SFC) 

All available PFCs and SFCs have numerical values assigned 
to them. Each is also represented by a symbolic name which 
can be gained through the use of keywords. (See 
appendix B.) 

A specific supervisory message is indicated by the pair 
PFC/SFC. This pair forms unique function requests. For 
example, the primary function code CON together with the 
secondary function code REQ forms the unique function 
code CON/REQ (connection request). 




Figure 2-8. Content of Text Area of 
'ENTERAINPUTAPLEASE' 

Along with every PFC and SFC, there are three other 
sections of a supervisory message: 



EB 



RB 



Parameter 
Field 



A 1-bit field error bit which is set to 1 to 
indicate error or abnormal response, 
either from NAM to the application or 
vice versa. 

A 1-bit field response bit which is set to 1 
in every normal response to a previous 
supervisory message, either set by the 
application as a response to NAM or vice 
versa. 

1 to 63 words of parameters passed 
between NAM and the application, 
dependent on the specific request. 



The general format of a supervisory message is shown in 
figure 2-9. The ABH accompanies every block being 
transferred whether it is a supervisory message block or a 
data block. The ABH format for an asynchronous super- 
visory message is shown in figure 2-10. The ABH for a 
synchronous supervisory message is shown in figure 2-11. 



NAM TO APPLICATION SUPERVISORY MESSAGES 

PFC/SFC Meaning 

CON/REQ NAM informs the application that a 

terminal or another application requests 
a logical connection. 

CON/CB Logical connection is broken (for example, 

line disconnect). 

FC/INIT NAM informs the application of the 

logical initialization of a connection. 

FC/ACK NAM acknowledges the delivery of a 

previously submitted block by the appli- 
cation. 



0200 1 00000020 00024 



L 



Text Length = 18 characters 

(+12 zero bits for DC unit separator) 

Character type = 4 

(Display Code, 10 characters per word) 



Connection number 1 



A MSG Block 



Figure 2-7. ABH Configuration of ■ENTERAINPUTAPLEASE 1 
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NAM to application messages are also used for the following 
functions: 

• Suspension or resumption of data traffic 

• Detection of an- inactive connection 

• Notification of network shutdown 

• Logical error in response to an illegally formatted 
request previously submitted by the application 

For the complete list of NAM to application supervisory 
messages, refer to appendix C. 



CON/END The application informs NAM that it has 

completed all processing on a logical 
connection. 

MSG/LOP The application sends a message to the 

local operator. 

Application to NAM messages are also used for the following 
functions: 

• Temporarily switching OFF and ON data input 
transmission 



APPLICATION TO NAM SUPERVISORY MESSAGES 

PFC/SFC Meaning 

CON/ACRQ The application requests connection to 

another application. Application can 
initiate connection request to another 
application, but cannot do the same to a 
terminal because this connection request 
comes only from NAM. 



Definition of terminal characteristics 



• Changing input character type as chosen by the applica- 
tion, in contrast to what is previously transferred by 
NAM 



For the complete list of application to NAM supervisory 
messages, refer to appendix C. 



word 1 



word 2 



word n 



59 


5 1 


5049 


43 


PFC 


E 
B 


R 
B 


SFC 


Parameters 


Parameters 


===:; k^ 


Parameters 



63 words 
maximum 



Figure 2-9. Format of Supervisory Message 
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Figure 2-10. ABH for an Asynchronous Supervisory Message 
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Figure 2-11. ABH for a Synchronous Supervisory Message 
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NETWORK ACCESS 



When writing an application in one of the high-level 
languages, AIP routines must be called in order to gain 
network access. 



All AIP routines begin with NET; routines used internally by 
AIP begin with NP$. To avoid possible naming conflicts, 
variables and entry point names should not begin with NET 
or NP$. 



AIP routines are divided into three groups: 
• Informative and control routines 

NETON Establishes network access. 

NETOFF Ends network access. 

NETWAIT Temporarily suspends the 
application. 

NETDBG Turns NAM debugging option 
on or off. 

NETSTC Turns NAM statistics capability 

on or off. 



NETON AND NETOFF 

In order to access the network and establish connections, the 
application must first call NETON. The FORTRAN format 



CALL NETON (nHaname,nsup,status,minacn,maxacn) 

NETON parameters are as follows: 

aname Application name, one to seven alpha- 

numeric display code characters, left- 
justified with blank fill. This name is used 
to identify the application, and must be 
made known to NAM before using it. 



nsup 



status 



A single-word variable into which NAM 
stores various flags during subsequent 
network calls. See figure 3-1. 

Another single variable, which indicates 
NETON success or failure. The values 
are: 

NETON is successful. 

1 Rejected because the network 
is not available. 



Data transfer routines 

Input routines (from NAM to the application): 

NETGET Gets input on a specified connection. 

NETGETL Gets input on a connection that is a 
member of a list. 

NETGETF Gets input on a specified connection, 
into a fragmented buffer. 

NETGTFL Gets input on a connection that is a 
member of a list, into a fragmented 
buffer. 

Output routines (from the application to NAM): 



NETPUT 



Sends output to a specified 
connection. 



NETPUTF Sends output on a specified 

connection, from a fragmented 
buffer. 



Parallel mode control routines 

NETSETP Selects or terminates parallel mode. 

NETCHEK Checks for completion of NAM call 
while in parallel mode. 



The preceding features of NAM, and their communication 
protocols, are expanded upon in the following subsections. 



maxacn 



2 Rejected because of duplicate 
application name. 

3 Rejected because application name 
is not known to NAM. 

A number that indicates the smallest ACN 
the application accepts. 

A number that indicates the largest ACN 
the application accepts. 



NAM assigns ACNs starting at minacn and not exceeding 
maxacn. The minacn and maxacn parameters must conform 
to the following specifications: 

< minacn £ maxacn « 4095. 

Example: 

CALL NETON (SHMYAPP,NSP,NST,5,12) 

Application MYAPP requests network access and is willing 
to accept only eight connections, starting with connection 
number 5 (minacn) and not exceeding connection number 12 
(maxacn). C, I, and S bits are returned in nsup (NSP) and 
accept/reject status is returned in status (NST). 

When the application desires to terminate network access, it 
calls NETOFF (no parameters are required): 

CALL NETOFF 

After calling NETOFF, the application continues to execute 
under control of the operating system. In order to resume 
network access, NETON is called again. 
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59 575655 



c 






1 


s 


unused 



reserved 

C* Complete bit. This bit is applicable in the parallel mode of operation only. Refer to section 6 for further explanation 
about this bit. 

I Input available bit. Set to 1 when input other than an asynchronous supervisory message is available to the applica- 

tion. Set to 0. otherwise. This bit is set only after calling NETWAIT. 

S Asynchronous supervisory message bit. Set to 1 if there are asynchronous supervisory messages available to the 

application. Set to otherwise. In contrast with the I bit, this bit is usually set or cleared after each AIP call, 
except NETSETP. (Refer to section 6.) 



Figure 3-1. NSUP Word 



NETGET, NETPUT, AND NETWAIT 

An application program can input data (NETGET), output 
data (NETPUT), and suspend processing (NETWAIT). These 
options are permitted by AIP statements. They are 
discussed in the following subsections. 



NETGET 

After network access is made possible, supervisory messages 
and input/output data traffic can begin. This can be 
accomplished by calling NETGET for input and NETPUT for 
output. 

The FORTRAN format of NETGET is 

CALL NETGET (acn,ha,ta,tlmax) 

This routine inputs one data block or a supervisory message 
from the specified connection. The header of the block is 
placed in the header area (ha), and the body of the block in 
the text area (ta). Text area is an array of at least 
maximum text length (tlmax) words. 

An application connection number of is used to obtain an 
asynchronous supervisory message. If no blocks are 
available for the specified connection, a null block is 
returned to the application, an ABH with an ABT of is 
placed in the header area, and the text area remains 
unchanged. If the block is longer than the maximum text 
length, the block is not transmitted, but remains queued 
within NAM. An ABH, which contains an IBU bit set to one 



and the true length of the block, is returned to the 
application. (See figure 3-2. See also section 5.) The text 
area (ta) remains unchanged. 

Example: 

CALL NETGET (0,IHA,ITA,63) 

This routine requests input from an ACN of 0. The ABH is 
placed in IHA, and the text is placed in IT A. ITA is an array 
of at least 63 central memory words. 



NETPUT 

The second routine is NETPUT. Its calling format is 
CALL NETPUT (ha.ta) 

This routine outputs one data block or a supervisory message 
from the text area (ta) to the connection; it does so 
according to the information placed in the header area (ha). 
In contrast to NETGET, an ABH is constructed and placed in 
the header area (ha) prior to calling NETPUT. 

The header area must at least contain the following 
information: 

• The connection number (placed in the ADR field) 

• The block type (placed in the ABT field) 



59 



19 



11 





1 

B 
U 




TLC 



IBU bit Set to 1 when the block's length is longer than the tlmax specified in NETGET (also applicable to NETGETL, 
NETGETF and NETGTFL). 

TLC Contains block's actual length. 



Figure 3-2. Format for Data Block Header 
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• The block character type (placed in the ACT field) 

• The block length in units (placed in the TLC field) 

For the following example, assume that NAM has assigned 
an ACN of 5. To output the display code characters 

INPUT PLS 

to the ACN of 5, an ABH is constructed which contains the 
information shown in figure 3-3. 

The header area is given an octal value by the statement 

IHA = 020D050000Q020000012B 

The following steps are required to prepare the text area 
and send the message: 

ITA(l) = 10H INPUT PLS 

ITA(2) = 

CALL NETPUT (IHA.ITA) 

NETWAIT 

If the application is suspended, or when the NSUP word 
should be updated, the NETWAIT subroutine must be called: 

CALL NETWAIT (time.flag) 

NETWAIT parameters are as follows: 



time 



flag 



Time in seconds that the application is 
suspended; must be in the range 1 through 
4095. If smaller than i, the default value of 1 
is substituted. If greater than 4095, the 
default of 4095 is substituted. 

A single variable that indicates recall con- 
dition. The values are: 

Returns control when input is available or 
time specified has elapsed, whichever 
occurs first. 

1 Returns control only when time specified 
has elapsed, regardless of input avail- 
ability. 



FIRST STEPS IN CONNECTION 
ESTABLISHMENT 

Suppose MYAPP, which handles up to a maximum of 10 
terminals, is a configured application known to the network 
software. ' NETON is called by writing 

CALL NETON (SHMYAPP,NSUP,NSTAT,1,10) 

Network access becomes possible only after NETON is 
complete with NSUP set to 0. NAM responds with 
CON/REQ supervisory messages on behalf of every terminal 
or application. 

Request by request, the application must decide whether to 
accept or reject the CON/REQ supervisory message. 
Rejection can occur for whatever reason the application 
chooses; for example, when the application deals with TTY- 
compatible terminals only and some other device requests a 
connection. 

If the application rejects the CON/REQ, it sets the error bit 
to 1 and NETPUTs this rejection message to NAM. If the 
application accepts the CON/REQ, it sets the response bit 
to 1 and NETPUTs this response message to NAM. At this 
point, data transfer between the requesting terminal and the 
application is not yet possible. The application can continue 
with some other processing or wait. 

After NAM receives the CON/REQ, and the response bit 
is 1, NAM responds with a flow-control initialized (FC/INIT) 
supervisory message and the application responds by 
accepting it. Data traffic now begins between the applica- 
tion and the requesting terminal or another application. 

The connection establishment steps are summarized in 
table 3-1. In this table, a specific supervisory message is 
indicated by the PFC/Sf C pair. 

A response to a supervisory message is indicated by the 
triplet 

PFC/SFC/OPT 

where: 

PFC/SFC are the supervisory message identifiers. 







59 53 


41 




23 19 


11 






ABT 


ADR 




ABN 




*\CT 


FLAGS 


TLC 










1 2 




5 








4 




14 8 










ACN 


= 5 










send 10 


characters 


2 = 


= MSG type block 






4 = display code 
character type 


followed by the 
display code unit 
separator 



Figure 3-3. ABH Configuration of 'AINPUTAPLS' 
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TABLE 3-1. CONNECTION ESTABLISHMENT CHART 



Step 
No. 



Description of Action 



Application 

AIP Routine 

Called 



Message 
Flow 



NAM 



Terminal 
(or Application) 



1. 
2. 
3. 



6. 



8. 



Application calls NETON. 

NETON was accepted by NAM (status of 0). 

A terminal user, or another application, is 
requesting the application; meanwhile, the 
application can drop the CPU and wait for 
supervisory message. 

NAM sends a CON/REQ supervisory message; 
application receives the message only after 
calling NETGET on an ACN of 0. 

Application accepts the CON/REQ by setting 
RB=1; N stands for RB=1, which is a normal 
response, and NETPUTs this message to NAM. 

Application can now do some other com- 
putations or relinquish the CPU by calling 
NETWAIT. 

Flow-control is initialized by NAM sending 
the FC/INIT. 

Application accepts the FC/INIT and 
NETPUTs the message back, setting RB=1. 

Data traffic can start now on the assigned 
ACN not equal to 0. 



NETON 



NETWAIT 



NETGET — 



CON/REQ 



NETPUT • 

NETWAIT 

NETGET 
NETPUT 
NETPUT 
NETGET 



CON/REQ/N 



- FC/INIT 
FC/INIT/N 



OPT indicates the type of response: 

N Normal response (RB=1) 
A Abnormal response (EB=1) 

For example, CON/REQ/N means a normal response to a 
CON/REQ supervisory message. 

The format of the supervisory messages involved in 
connection management is shown in figure 3-4. 

A normal response of the application to NAM for the 
CON/REQ SM is shown in figure 3-5. An abnormal response 
is shown in figure 3-6. FC/INIT from NAM to the 
application is shown in figure 3-7; a normal response of the 
application to this request is shown in figure 3-8. An 
abnormal response to this request is shown in figure 3-9. 

FIRST SAMPLE PROGRAM 

EASY, a sample program, is shown in figure 3-10. This 
sample program demonstrates how an application program 
communicates with the network. It identifies the use and 
format of the following NAM terms: 

• The application connection number (ACN) 

• The application block header (ABH) 

• The supervisory message (SM) 



• The text area (ta) 

• The header area (ha) 

EASY also identifies the use and format of the following AIP 
routines: 



• 


NETON 


• 


NETWAIT 


• 


NETGET 


• 


NETPUT 


• 


NETOFF 



The remarks column, on the right in figure 3-10, explains 
the step-by-step activity of the program. 

NFETCH AND NSTORE SUBROUTINES 

Using masks and special purpose constants, accessing 
supervisory messages, and block header fields is awkward. 
Besides the disadvantage of having to be aware of the exact 
structure and value, it is good programming practice not to 
use masks and special purpose constants. Instead, the 
NFETCH and the NSTORE subroutines are used. These 
routines must scan a table for matching the keywords; 
scanning causes some increase in program execution time. 
Therefore, it is advisable to set up as many constants as 
possible, at initialization time only. 
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symbolic 
name _ 
value 



59 



CON 



51 50 49 43 



35 33 






63 16 00 00g 



REQ 



m 



(NAM to Application) 



21 171615 13 



ABL 

"abl " 



TNAME or ANAME 



DT TC 



PW 



PL 




acn The assigned application connection number. 

abl The application block limit. 

DT, TC, PW, and PL are device type, terminal class, page width and page length, respectively. TNAME or ANAME are 
1 through 7 alphanumeric characters of terminal or application name, respectively, left-justified, blank-filled with a leading 
alphabetic character. 



Figure 3-4. Format of Connection Management Supervisory Messages 



... 


(Application 
59 51 50 49 43 35 23 


to 


NAM) 
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value 
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E 



R 
1 


REQ 

oo 8 




CONACN 
acn 




ACT 
act 


ALN 
aln 




act The initial input appli 
aln The application list ni 


cation character type as determined by the application, 
jmber. 











Figure 3-5. Normal Response Format for Connection Request (CON/REQ/N) 



(Application to NAM) 
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Figure 3-6. Abnormal Response Format for Connection Request (CON/REQ/A) 
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(Application to NAM) 





59 


51 50 49 


43 


35 


23 





symbolic name 


FC 


E 
B 


R 
B 


INIT 




FCACN 




value 


83 16 








07g 
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Figure 3-7. Flow-Control/Initialized Format (FC/INIT) 
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Figure 3-8. Normal Response Format for Connection Initialized (FC/INIT/N) 
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83 16 
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07 8 
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Figure 3-9. Abnormal Response Format for Connection Initialized (FC/INIT/ A) 



NFETCH FUNCTION 

NFETCH is used to fetch a specified field. For example: 

var = NFETCH (arr,nl_keyword) 

where: 

arr indicates an array that contains the table 

from which the specified field is 
extracted. If an arr is 0, then a constant 
value represented by keyword is returned 
rather than a field from a table. 



keyword 

For example: 
KKK 



indicates a symbolic field name. 



NFETCH (TA,6LPFCSFC) 

KKK contains the combined primary and 
secondary function code from array TA. 



LLL = NFETCH (0.6LFCINIT) 

LLL contains the constant represented by 
FCINIT (8307 16 ). 

NSTORE FUNCTION 

NSTORE is used to store a value in a table. For example: 

CALL NSTORE (arr,nLkeyword,val) 
where: 

indicates an array that contains the table. 



arr 
keyword 

val 



is a symbolic name of the field in the 
array into which the value is to be stored. 

is a numeric or alphanumeric value to be 
stored. 
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Step 






No. 


PROGRAM EASY (OUTPUT) 


Remarks 




INTEGER PF,SFC,CON,REQ,FC,S,SMHDR 


Set constants 




INTEGER DTHDR,HA,TA(63> 


63 16 




CON=306000000000000000003 






REQ=0 






FC=«t06 00 000 00 0000000000B 


83 16 




INIT=O00O3«*00 000O00O000Q0B 


07 16 (in bits 44 through 49) 




SHHOR- 03 000 00 000000<>000001B 


ABH for 1 word supervisory message 




OTHOR* 02 00000 OQ0002000002W 


ABH for 10 character display code 


1 


CALL NETON (5HMYAPP,NSUP,NSTAT ,1,10) 




2 


IF (NSTAT.EQ.O)GO TO h 
PRINT 10 0,NSTAT 


Check if NETON has been accepted. 




100 FORMAT (»NETON FAILED, NSTAT*», 020) 


NETON failed. Print NSTAT value to find out 
failure reason, disconnect application and drop. 




STOP 111 




3 


• 


Some other computations can now be made. 




• 
• 


followed by a NETWAIT. 




5 CALL NETHAITU095.0) 






S*SHIFT(NSUP,-55),AN0.1 






I=SHIFT(NSUP,-56).AND.l 






IF(S.EQ.l) GO TO 6 






IF (I.EQ.l)GO TO 10 






GO TO 5 




4 


6 CALL NETGET(0,HA,TA,63) 

PFC=TA.AND. 7760000 00 0000000000 OB 
SFC=TA .ANO.00037<t0000000O000000B 


Supervisory message is available and can be 
accessed through a NETGET. 




IF (PFC.EQ.CON.AND.SFC.EQ.REQ) GO TO 7 


Is it a CON/REQ? 




IF (PFC.EQ.FC.AND.SFC.EQ.INIT) GO TO 8 


IsitanFC/INIT? 




PRINT 101, HA, TA 






101 FORMAT (•UNKNOHN SUP. MESSAGE »,6M/, IX, 020/) ) 


Unknown supervisory message, print header 
and text areas, disconnect and drop. 




CALL NET OFF 






STOP 222 






C CON/RE Q PROCESSING 






7 ACN=SHIFT(TA,-2«t).AN0.7777B 


Proceed with a normal response to CON/REQ. 




TA=TA. OR. 000^00000000000003008 


Set RB=1,and ACT=3. 




HA=SMH0R 


Set ABH for 1 word supervisory message. 


5 


CALL NETPUT (HA,TA) 

■ • 
• 


Send response to NAM. 


6 


• 

GO TO 5 
C FCINIT PROCESSING 


Look for input or another supervisory message. 


7 


8 ACN=SHIFT(TA,-2ii).AND.7777B 






TA=TA. OR. 00 01,00000000000000008 


Set RB=1 




HA»SMHDR 




8 


CALL NETPUT (HA,TA> 






■ 


At this point, input data can be available or 




• 


output data can be sent to terminal on 




• 


assigned ACN. 




TA=10H INPUT PLS 


Construct the message "INPUT PLS". 




TA(2>*0 






ACN=SHIFT(ACN,«t2) 


Set ABH to reflect display data. 




HA=OTHOR.OR.ACN 


Send the output message and go wait for input. 


9 


CALL NETPUT (HA, TA) 
GO TO 5 
C INPUT IS AVAILABLE 






19 CALL NETGET<ACN,HA,TA,1) 

• 


Input is available here. 




* 
• 

ENO 





Figure 3-10. Sample Program EASY 
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KEYWORDS 

Keywords can be made easier if the logic behind the 
keyword names is understood. All the application block 
header word keywords start with ABH. For example: 

ABHABT is the keyword for the ABT field in the 
application block header word. 

ABHACT is the keyword for the ACT field in the 
application block header word. 

Also for the text area, associated fields of every supervisory 
message are prefixed with the PFC name. For the 
PFC=CON, the AGN and ALN fields are referenced as 
CONACN and CONALN, respectively. For the PFC=FC, the 
ACN and ABN fields are referenced as FCACN and FCABN, 
respectively. 



For the general usage of a supervisory message, the 
following keywords exist: 

PFC The primary function code field 

SFC The secondary function code field 

PFCSFC The combined field of the PFC and SFC 

EB The error bit field 

RB The response bit field 

RC The reason code field 

For the complete list of all the keywords, refer to 
appendix B. 

The first sample program revised, using NFETCH and 
NSTORE, is shown in figure 3-11. 

THE APPLICATION LIST NUMBER 



NETGET) always results in the return of a null block if there 
is currently no input available from the specified ACN. 
NETGETL returns the null block only if there is no input 
available for all the ACNs in the specified ALN. 



The ALN is both more convenient and more efficient' than 
ACN. The ALN should be used whenever an application 
handles all terminals the same, in which case it places them 
all in the same ALN. If an application desires to handle 
batch and interactive terminals in a different manner, it 
assigns all the batch terminals to ALN-1, and all the 
interactive terminals to ALN=2. 



The ALN is made known to NAM by specifying it in every 
response of the application to the CON/REQ message from 
NAM. Recalling the normal response format of the 
application to CON/REQ in figure 3-5, the ALN field is 
shown in figure 3-12. In the sample revised program, to 
access all terminals on an ALN of 1, add the ALN field by 
calling NSTORE during CON/REQ processing (after state- 
ment 7 and before calling NETPUT). See figure 3-13, 
CON/REQ Processing. 



NETGETL 

To get input on a list of ACNs use NETGETL; the calling 
format is 

CALL NETGETL (aln,ha,ta,tlmax) 
where: 



aln indicates one of the ALNs chosen by 

the application and previously made 
known to NAM in response to its 
CON/REQ supervisory message. 

ha,ta,tlmax indicates header and text area, and 

maximum text length, as covered 
under NETGET. 



The application list number is used to avoid specifying 
different ACNs for every terminal that sends input. The 
ACN is specified whenever data is input from a specific 
connection, which is equivalent at any given time to one 
specific terminal. 



An ALN of is a valid list number. It differs from ALNs not 
equal to by the fact that it inputs data both from ACNs 
of and ACNs not equal to 0. ALNs not equal to input 
data only from ACNs not equal to 0. To NETGET on an ALN 
of 0, all asynchronous supervisory messages are delivered 
before data from any ACN not equal to 0. 



On input only, it is possible for the application to group 
several ACNs together to form the ALN. The ALN is a 
6-bit integer value that is determined by the application (in 
contrast to the ACN, which is assigned by NAM). 



The ALN enables the application to receive data from 
several terminals without specifying the ACNs for every 
terminal. By specifying the ALN only, data comes in a 
round-robin fashion, each time from one single terminal. 



In order to input data using ALNs, the AIP NETGETL routine 
is called, rather than NETGET. 



When the response to a CON/REQ supervisory message 
contains an ALN of 1, replace the call to NETGET with a 
call to NETGETL. This replacement is necessary only when 
data is input. For example, the revised sample program 
statement 10 is replaced by 



10 



CALL NETGETL (1,HA,TA,1). 



When responding to a NETGETL request, ACNs with empty 
input are skipped, and data is transferred only from the next 
ACN that has input available. Using a specific ACN (on 



Changing the NETGET call at statement 6 of the revised 
sample program to a NETGETL is not necessary since it 
deals only with asynchronous supervisory messages. 
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The changes made are marked by shading: 






PROGRAM EAS* COITPUTI 






INTEGER PFCSFC.CONREOiFCMIT.S 






INTEGER SMH0R,DTH0R,HA,TA<63) 




C 


SET UP CONSTANTS 

SMHOR=0 

CALL N$T0RE<SHH0R.6LABHABT.3> 

CALL NSTORE(SHHDR,6LABHACT»l> 

CALL **■: 3R£ tSMHOR.61 ABHTi.3,1 1 

3THDR=0 

CALL NST0RE<0TH0R,6LA8HABT.2» 

CALL NST0RE(0TH0R»6LABHACT,t»> 

CAL . NSTORE (OTHUR.ftt »BHTl: . i B> 

: inre j ->s--t -■:-:: j,6lconre«i 

FCI «T=NFfcTCH (0,61 FCINIT1 

CALL NETONC5HMYAPP,NSUP,NSTAT, 1,101 

S=SHIFT<1,55> 






I=SHIFTtl*S6> 






IF CNSTAT.EQ. 01GOTO k 






PRINT 10 0.NSTAT 




100 


FORMAT <»NETON FAILED. NSTAT=»,O20> 
CALL NETOFF 
STOP 111 

• 




5 


• 
• 

CALL NETMAITU09S.0) 




C 


CHECK FOR A SUP. MESSAGE OR INPUT AVAILABLE 
IFtNSUP.AND.SI 6.3 




3 


IFCNSUP.ANO.I) 10*6 




C 


SUP. MESSAGE IS AVAILABLE 




6 


CALL NETGET(0,HA,TA,63) 
PFCSFC=NFETCH(TA,6LPFCSF:i 
IF tPFCSFC.EQ.CONREQ) GO TO 7 
IF tPFCSFC.EQ.FCINITJ GO TO 8 
PRINT 101.HA.TA 




101 


FORMAT (»UNKNONN SUP. MESSAGE * ,6«tC/,lX, 020/ 1 ) 
CALL NETOFF 
STOP 222 




C 


CONREO PROCESSING 




- 


ACN=MFETCH(T« .6LC0NACN) 

■;t..L -v. -i 6 :: [ta,2lr3,ii 

CALl USTORE <TA,6LC0NACT, " 

HA = SMHCR 

CALL NETPUT(HA.TA) 

• 
• 

GO* TO 5 




c 


FC/INIT PROCESSING 




> 


acn=nfetch(ta.5lfcacn> 
;■'.. ;. nstorem «,?.-: ■-. ;.■ 

HA = SNHOR 

CALL NETPUT(HA.TA) 

• 
• 

TA=10H INPUT PLS 

TAC2) = 

HA=OTHDR 

CALL NST0RE(HA,6LABHACN,ACN) 

:.4.„ NETPUTtHA.TA) 

GO TO 5 




C 


INPUT IS AVAILABLE 




10 


CALL NETGET(ACN,HA,TA,1) 

• 

• 

END 





Figure 3-11. Sample Program EASY Revised 
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59 51 50 49 43 
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23 


9 5 




symbolic name 
value 


CON 
63 16 


E 

B 




R 

B 

1 


REQ 

00g 




CONACN 




ACT 


ALN 

















Figure 3-12. Field of Application List Number (ALN) 



The changes made are marked by shading: 

C CONREQ PROCESSING 

7 ACN*NFETCH<TA,6LCONACN) 
CALL NSTORE(TA,2LR8,l> 
CALL NSTOREtTA,6LCONACT f 3» 



CALL NETPUTCTA.HA) 
ENO 



Figure 3-13. CON/REQ Processing 

In summary, the differences between NETGET and 
NETGETL are as follows: 

NETGET 

• Inputs data only on a specific ACN, which can be one of 
the following: 

A specific terminal 



A certain application 

An asynchronous supervisory message an ACN=0 

• Returns the null block if there is no input available on 
the specified ACN. 

NETGETL 

• Inputs data in a round-robin fashion; each call inputs 
data from a different ACN. The ACNs from which data 
was input were previously grouped by specifying an ALN 
in response to every CON/REQ supervisory message 
from NAM. 



• Accesses asynchronous supervisory messages only on an 
ALN of 0. All asynchronous supervisory messages are 
delivered before any data from ACNs not equal to 0. 

• Skips ACNs that do not have input available. The null 
block is returned only if no ACN in the list has input 
available. 



3-10 



60480400 A 



DATA FLOW AND ERROR CONTROL 



The first sample programs recognized only two supervisory 
messages, the CON/REQ and the FC/INIT. The application 
can also initiate more requests to NAM enabling it to have 
better control and overall greater flexibility. Other 
supervisory messages and extra features supported by NAM 
are explained in detail in the following sections. Appendix C 
provides a complete list of all supervisory messages and 
their meanings. 



LOGICAL CONNECTION BREAKAGE 

A logical connection can be broken at any time by either the 
application or by NAM. The application can either initiate 
disconnection or be informed of disconnection by NAM. 



APPLICATION INITIATES THE DISCONNECT 

If the application is to be disconnected from a specific 
logical connection, it sends the CONnection/END 
supervisory message, as shown in figure 4-1. The 
disconnected ACN is now free, and is available for 
reassignment. 



Application 



NAM responds: 



SM 
CON/END - 

CON/END/N 



NAM 



Figure 4-1. CONnection/END Supervisory Message 



APPUCATION IS INFORMED OF THE DISCONNECT 

In this case, the application receives a CON/CB SM from 
NAM, with a code giving the reason for the disconnect. 
After receipt of this message, the application should not 
NETPUT on that connection, but can still NETGET until a 



null block is received. The application then sends the 
CON/END SM. NAM responds by sending a CON/END/N 
response, after which the ACN is made free and can be 
reassigned to a new connection. See figure 4-2. 



Normal disconnection processing steps are: 

Application SM 

-« CON/CB 

CON/END 



NAM 



CON/END/N 



Or if the application is willing to accept NAM's CON/REQ 
but NAM cannot complete the logical connection establish- 
ment, the steps can be: 



Application 



SM 

CON/REQ 
CON/REQ/N 

- CON/CB — 

- CON/END - 



NAM 



CON/END/N 



Figure 4-2. Connection Breakage Steps 

The CON/CB and the CON/END formats are shown in 
figures 4-3 and 4-4, respectively. A new application can 
automatically be assigned after terminating the current 
application activities with the CON/END. 

If application MYAPP is written to recognize a special type- 
in to terminate the connection (such as TERM), and allows 
the terminal user to type in the next application name (for 
example, TERM,IAF), application MYAPP can then be 



59 


51 50 49 


43 


35 


23 





CON 


F 
B 


H 
B 


CB 


RC 


CONACN 




63 16 








05 8 


re 


acn 





acn The ACN on which the connection was broken. 

re The reason code for breaking the connection and it can be: 

1 ..= line disconnect 

2 = connection broken by NAM (for example, a result of bad parameter on CON/REQ/N) 



Figure 4-3. Format for Connection Broken (CON/CB) 
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B 


R 
B 


END 


RC 


CONACN 




63 16 








06g 





acn 




aname 




param-j 



param n 



acn The ACN to be ended. 

aname 1 through 7 alphanumeric display code characters with a leading alphabetic character specifying the name of 

the application to which the connection should be switched. 

param 1 to Parameters passed to the new application. 
param n 



Figure 4-4. Format for Connection Ended (CON/END) Application to NAM 



triggered to do a CON/END specifying IAF as the next 
application to which the terminal user is connected. 
Whether or not an application specifies the name of another 
application in its CON/END message, it receives a response 
message with the format shown in figure 4-5. 

DOWNLINE FLOW CONTROL 

Downline flow control involves acknowledgment/- 
nonacknowledgment of block delivery and stop versus break. 

ACKNOWLEDGEMENT/NONACKNOWLEDGEMENT 
OF BLOCK DELIVERY 

Because host computers are faster than terminals, it is 
possible for an application to send blocks along a particular 
connection faster than can be output at the terminal. It is 
also possible for the same application to send blocks so 
slowly that the terminal is underoccupied. Therefore, NAM 
provides a set of programming conventions allowing the 



application program to control the flow of data between the 
application and its terminals. 

The application block limit (ABL) field is found in the 
CON/REQ supervisory message format. (See figure 3-4.) 
The ABL is established for each logical connection. It 
indicates how many blocks of data an application can have 
outstanding at the requested ACN at any given time. 

As blocks are delivered to the terminal, an FC/ACK 
(acknowledge) supervisory message is returned to the 
application. If, for any reason, a block cannot be delivered, 
an FC/NAK (negative acknowledge) supervisory message is 
returned instead, and the block is lost. The application can 
attempt recovery by sending the lost block again. However, 
if more blocks have been sent following the lost block, the 
lost block might be delivered out of sequence. 

The FC/ACK and the' FC/NAK supervisory messages do not 
require responses from the application. The FC/ACK and 
FC/NAK formats are shown in figures 4-6 and 4-7, 
respectively. 





59 515049 43 


35 


23 









CON 


E 
B 


R 
B 


END 


RC 


CONACN 






6316 





1 


06 8 





acn 

















Figure 4-5. Format for Connection Ended (CON/END/N) NAM to Application 
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(NAM to Application) 
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5 





FC 
83 16 


FT? 

B B 



ACK 
02 8 




FCACN 
acn 


FCABN 
abn 





acn The ACN along which the block was delivered, 
abn The ABN of the delivered block. 



Figure 4-6. Format for Block Delivered (FC/ACK) 
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FC 
83ie 


B 



R 



NAK 
03 8 


RC 
re 


FCACN 
acn 


FCABN 
abn 





re The reason code explaining why the block cannot be delivered: 

1 = Lost block, (occurs only because of a system error) 
acn The ACN along which a block cannot be delivered, 
abn The ABN, which cannot be delivered. 



Figure 4-7. Format for Block Not Delivered (FC/NAK) 



If the number of blocks exceeds the value of ABL, an 
ERR/LGL (logical error) supervisory message is sent to the 
application, along with the reason for the error. The block 
to be delivered is discarded by NAM. 



The following strategy is used to control the flow of blocks 
for delivery: 

1. Define two vectors K(n) and M(n), where n is the largest 
ACN possible. 

2. Set K(i)=0 and M(i)=ABL upon receipt of CON/REQ on 
ACN=i. 

3. Set K(i)=K(i)-l whenever an FC/ACK (block delivered) 
supervisory message is accepted for ACN=i. 

4. Set K(i)=0 whenever an FC/BRK (break) is received for 
ACN=i. 

5. Set K(i)=K(i)+l and output one block on ACN=i, when a 
block is to be output to NAM and K(i) < M(i). If 
K(i) & M(i), wait until K(i) is decreased by step 3. 



STOP VERSUS BREAK 

Network conditions occasionally require the suspension of 
downline data traffic on a logical connection. When one of 
these conditions occurs, the application is notified to stop 
block delivery on the specified ACN until the condition has 
cleared. 



If the NPU is able to determine when the condition has 
cleared, the NPU causes NAM to send an FC/STP (stop) 
supervisory message to the application, requesting it to 
suspend data traffic. The application then waits for an 
FC/STA (start) supervisory message from NAM. When the 
FC/STA is received from NAM, the application sends an 
FC/RST (reset) to enable traffic to resume. The FC/STP, 
FC/STA, and the FC/RST formats are shown in figures 4-8, 
4-9, and 4-10, respectively. 



Application 



SM 
FC/STP 



NAM 



NAM discards all outstanding output. The application 
must wait for FC/STA. 



FC/STA 
FC/RST 



Normal communications may now resume. 



Figure 4-8. FC/STP Protocol 



If the NPU is not able to determine when the condition has 
cleared or, if a user break occurs, then an FC/BRK (break) 
supervisory message is sent to the application. When the 
FC/BRK is received from NAM, the application sends an 
FC/RST which enables traffic to resume. The FC/BRK 
format is shown in figure 4-11. 
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Application 



FC/BRK 



NAM 



All outstanding output is discarded. The application 
should send: 



FC/RST 



Normal communications may now resume. 



Figure 4-9. FC/BRK Protocol 

When a stop condition occurs, the following events take 
place: 

1. The blocks that were output by the application but not 
acknowledged by NAM are discarded. 

2. An FC/STP message with the following information is 
sent to the application: 

• The ACN of the stopped connection 

• The code giving the reason for the stop 

• The ABN of the last acknowledged downline block 
(zero if none) 



3. The application uses NETGET to fetch any pending 
input until a null block on ACN or an FC/STA is 
received. 

4. The application receives an FC/STA. 

5. The application sends an FC/RST message to resume 
data traffic. The FC/RST message does not require a 
response from NAM. 



The FC/STP protocol is shown in figure 4-12. 

When a break condition occurs, the following events take 
place: 

1. The blocks that were output by the application but not 
acknowledged by NAM are discarded. 

2. An FC/BRK message with the following information is 
sent to the application: 

• The ACN of the .connection on which the break 
condition occurred 

• The code specifying the reason for the break 

• The ABN of the last acknowledged downline block 
(zero if none) 







(NAM to Application) 
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STP 


RC 


FCACN 


FCABN 




"1 


acn 




83, 6 








05 8 


re 


acn 


abn 




_J 


ACN of the 


stopped connection. 






abn 


ABN of the last acknowledged block, zero if none. 






re 


Reason code for stop: 

1 = Terminal busy 

2 - Terminal failure 







Figure 4-10. Format for Stop (FC/STP) 
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R 


R 
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STA 




FCACN 






| 83 16 








06 8 




acn 













Figure 4-11. Format for Start (FC/STA) 
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4. 



The application sends an FC/RST to resume data 
traffic. The FC/RST message does not require a 
response from NAM. 

The application uses NETGET to fetch any pending 
input until a null block is received. 



The FC/BRK protocol is shown in figure 4-13. 

INACTIVE CONNECTION AND HOST 
SHUTDOWN 



Whenever NAM detects that 10 minutes have elapsed 
without any message traffic over a connection, it sends the 
FC/INA (flow-control/inactive) supervisory message to the 
application. Whether further action is performed on that 
connection depends on the coding of the application 
program. For example, the application can send a message 
to the terminal operator, disconnect the terminal, or do 
whatever is appropriate. 



NAM continues sending the FC/INA supervisory message at 
10-minute intervals, as long as there is no activity on the 
connection. The format of the FC/INA is shown in 
figure 4-14. The FC/INA message does not require a 
response from the application. 



SHUT/INSD SUPERVISORY MESSAGES 

The network operator can request idle down of network 
activities, or an immediate network shutdown by disabling 
the network. In either case, NAM sends the SHUT/INSD 
supervisory message to every application connected to it. 
The SHUT/INSD supervisory message is shown in 
figure 4-15. 

If i is equal to 0, the application is allowed to end its 
current activities by issuing a CON/END message for every 
connection and a NETOFF. If i is equal to 1, immediate 
shutdown has been requested, and the application should 
issue NETOFF at once. 



ERROR HANDLING 

When the application sends an ill-formatted request to NAM, 
an ERR/LGL (logical error) supervisory message is queued 
for the application, informing it of the kind of error 
detected. The application inputs the ERR/LGLs queued for 
it, and takes action according to the error codes reported to 
it. 

A counter is incremented each time an ERR/LGL is sent to 
the application. This procedure prevents deadlock situations 
when an application is outputting an infinite number of 
erroneous messages, and never obtaining the resulting 
ERR/LGLs queued for it. This counter is reset to zero every 



(NAM to Application) 
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FC 
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ft 



BRK 
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RC 
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FCACN 
acn 


FCABN 
abn 








acn 
re 



abn 



ACN of the connection on which a break condition occurred. 
Reason code for break condition: 

1 = User break 1. Caused by user input of the defined B1 key for his terminal, normally : . 

2 = User break 2. Caused by user input of the defined B2 key for his terminal, normally ) . 

3 = Output device not ready. 

4 = Incorrectly formatted data. 

ABN of the last acknowledged block, zero if none. 



Figure 4-12. Format for Break (FC/BRK) 



(Application to NAM) 
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acn ACN of the connection to be reset. 



Figure 4-13. Format for Reset (FC/RST) 
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(NAM to Application) 



59 
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ACN of the connection observed inactive. 



Figure 4-14. Format for Flow-Control/Inactive (FC/INA) 



i=0 
i=1 
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SHUT 


E 
B 


R 

B 


INSD 








4 ?16 








06o 




i 


The operator has requested an idle-down of network activities. 
The operator is disabling the network. 







Figure 4-15. Format for Host Shutdown (5HUT/INSD) 



time the number of supervisory messages queued for the 
application is down to zero. Zero indicates that the 
application has read all of its outstanding supervisory 
messages. Once the counter has reached 100, NAM ignores 
any supervisory message resulting in another ERR/LGL until 
the counter of outstanding messages has decreased to zero 
again. 



The counter mechanism protects NAM from accumulating an 
infinite number of ERR/LGLs queued for an application; 
however, it cannot make the application end its erratic 
behavior. An application can input all outstanding super- 
visory messages queued to it, including the ERR/LGLs, but 
disregard or misinterpret the ERR/LGLs and continue 
outputting an endless number of erroneous messages. In this 
case, the NAM counter never reaches 100 and the 
application remains in an erroneous loop. 



The ERR/LGL format is shown in figure 4-16. 



For greater detail about error codes, refer to the NAM 1 
reference manual. 



THE ECHO PROGRAM EXAMPLE 

The ECHO program accepts every terminal requesting it, up 
to a maximum of 20. After connection is initialized, it 
sends the message INPUT PLS and then expects an input of 
any character string terminated by a carriage return (CR). 
It then echoes the string to the terminal, followed again by 
INPUT PLS, and waits for new input. 

If one of the two user break keys defined for the terminal, 
normally the colon (:) or right parenthesis ( ) ), is hit, ECHO 
responds by sending BYE BYE and resumes normal echo 
mode. When more than 10 minutes have passed without 
terminal activity, the message TIMEOUT is sent to the 
terminal, which is then disconnected. An input of ten zeros 
from any terminal terminates ECHO. 

The ECHO program is shown in figure 4-17. 
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Figure 4-16. Format for Logical Error (ERR/LGL) (Sheet 1 of 2) 
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re Reason code for error: 

1 = illegal ACT value 

2 = Illegal TLC yalue 

3 = Illegal ABT value 

4 = Invalid ACN 

5 = ABL exceeded 

6 = NAM'S counter of outstanding ERR/LGLs has reached 100. No more ERR/LGLs are sent, until the 

number of outstanding supervisory messages is zero again. 

7 = Illegal or illogical supervisory message 

8 = Fragmented input/output error 

ABH If this word is nonzero, this is a copy of the ABH for the message causing the logical error. 

FWTA This is the first word of the text area of the message which caused the logical error. FWTA is sent only if 
ABH is nonzero. 



Figure 4-16. Format for Logical Error (ERR/LGL) (Sheet 2 of 2) 



PROGRAH ECHOJOUTPUT) 
S LOOP SACK TEST DEMONSTRATION PROGRAH 

IMPLICIT INTESER (A-21 

COMMON K,L,I,S,NSUP,NSTAT,SNH0R,0SH0R,ASHDR 

COMMON CONENO,FCRST,FCSTA,ACN»ABN,SMC20> ,A8L (20> ,NB(20) , HA,TA (631 
t INITIALIZE AND SET CONSTANTS 

C K IS THE APPLICATION BLOCK NUMBER COUNTER 

K=l 
C S AND I ARE NSUP WORD FIELD MASKS 

S=SHIFTU,55» 

I=SHIFTtl,56) 

00 15 LL=1,20 
IS ABL«LL»=NBtLL)=0 
C SNHOR - SUPERVISORY MESSAGE HEADER CONSTANT 

C OSHOR - OISLAY SOOE OUTPUT HEADER CONSTANT FOR MSG BLOCK 

t APHOR - APPLICATION-TO-APPLICATION COMMUNICATION HEADER CONSTANT 

SMHOR =030000000000040000018 

OSHOR =020000000000200000246 
C SET APPL. TO NAM SM CONSTANTS 

CONENO=NFETCH(0,6LCONENO> 

FCRST =NF£TCH»0,5LFCRST) 

FCSTA=NFETCHCQ,5l.FCSTA> 
C BUILD A BRANCHING TABLE FOR SUPERVISORY MESSAGES 

SM(il*NFETCH<0,5LFCACK> 

SM<2>*NFETCH(0.6LCONREQ> 

SH(3)*NFETCH(0 t 6LFCINIT> 

SMH»)=NFETCH(0,5LFCBRK) 

SM(51=NFETCH(0,5LFDSTP) 

SMt6»=NFETCHia,5LFCINA> 

SH(7)=NFETCH<0,5LC0NCe> 

SM(»)=NFETCH(Q,5LFCNAK) 

SM (9) *NFETCH< , 6LERRLGU 

SMI1Q>*NFETCH10,6LSHUINS> 

SMCU>=NFETCHC0,5LFCSTA> 

SM(12)=999 
C ESTABLISH NETNORK ACCESS 

CALL NET0NI6HTAPPL4, NSUP ,NSTAT, 1,201 
C TEST FOR NETON ACCEPTANCE 



Figure 4-17. The ECHO Program (Sheet 1 of 4) 



60480400 A 4-7 



IF (NSTAT.EQ.O) GO TO 5 
PRINT 10 0,NSTAT 
10 a FORMAT (* NSI AT = *,022» 
iTOP 111 

5 CALL L00K3M 

&0 TO <5,5,f»0,5t5,5,5,5,5,5,5,999) ,L 

5 INITIALIZE CONNECTION BY SENDING OUTPUT 
■»G HA=OSHOR 

CAi-L NST0R£<HA,6LA8HAD*,ACM 

TA(1)=10H INFUT PLS 

TA(2)=Q 

CALL OUTPT 

GO TO 5 
999 ALN=1 

CALL NEIG£TL<ALN,HA,TA,63> 

ABT=NFETCH(HA,6LABHABT) 

ACT=NFETCH (HA* 6LABHACT) 

ACN=NFETCH(HA,6LA8HA0R) 

TLC=NFETCH(HA,6LA8HTLC) 
i BRANCH TO PROCESS A OATA BLOCK 

IF(A6T.NE.3) GO TO b 

PRINT •,* SM RECEIVEO WHEN INPUT OATA hAS EXPECTED ON ACN . =*,ACN 

PRINT 1Q1,HA,TA 
101 FORMAT (* HA = *,O20/» TA = »/63<lX,O20/> ) 

GO TO 5 

6 HA=HA.ANO.7777777777777MJ0 77778 

C TEST FOR 10 DISPLAY CODE ZEKOES WHICH SIGNAL END OF ECHO RUN 

1F(TA(1) .EQ.1OHQ0OO00O00Q) GO TO 555 
C CHANGE BLOCK TYPE TO 3LK BLOCK 

CALL NST0REtHA,6LABHABT,l> 
i INHIBIT FORHAT EFFECTORS 

CALL NST0RE(HA,6LABHNF£,1) 
C ECHO INPUT AS OUTPUT, AFTER AODING A UNIT SEPARATOR 

C FOR ABT=4,0ISPLAY CODE, THE UNIT SEPARATOR MUST BE 12 BITS 

C OF ZERO RIGHT JUSTIEu. I.E. IF THERE IS ONE OR ZERO CHARACTER 

C POSITIONS REMAINING (XTRA) THEN ANOTHER WORD OF ZEROS WILL <JE 

6 ADOEO. 
FUlWD=TLC/10 
XTRA=TLC-1Q»FULWD 
ZFILL=iQ-XTRA 
TLC=TLC*ZFILL 

NASK=77OO00Q0QQOQOOO00COO8 
IF(XTRA.EQ..O)TA(FULWO<H> = 

TA IFUL HO+1 ) *T A (FULHD* 1 ) .ANO. SH IFT (MASK, - (6»XTRA) ) 
IF(ZFILL.NE.l) GO TO 71 
TLC=TLC*10 
TA(FULHD*2)=C 
71 CALL NST0RECHA,6LABHTLC,TLC> 
CALL OUTPT 
CALL LOOKS M 

GO TO (4*0,5,40,5, 5,5,5, 5,5, 5, 5, 999), L 
C SEND CON/END TO ALL ACTIVE CONNECTIONS 

555 TA(1)*0 

CALL NST0REfTA,6LPFCSFC,C0NEND) 

HA=SMHOR 

DO 556 LL=i,2Q 

IF(ABL(LL).EQ.Q) GO TO 556 

CALL NST0R£lTA,6LCONACN,LL> 

CALL NETPUT(HA,TA) 

556 CONTINUE 
CALL NETCFF 
STOP 777 
END 



Figure 4-17. The ECHO Program (Sheet 2 of 4) 
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SUBROUTINE LOOKSM 




t# 


PROCESS ASYNCHRONOUS SUPERVISORY MESSAGES 
IMPLICIT INTtGfcR <A-Z> 
COMMON K,L,I,S,NSUP,NSTAT,SMHOR,DSHOR,ASHQR 






COMMON CONENQ, FCRST,FCSTA, ACN, ABN,SMi20) ,ABl< 20) ,NB(20> 


,HA,TA(63) 




L=12 




i» 


CHECK FOR OUTSTANDING SUPERVISORY MESSAGES 
IF(NSUP.ANO.S) 6,3 




4* 


PAUSE FOR INPUT DATA OR A SUPERVISORY MESSAGE 
3 GALL NcTHAIT (4095,0) 

IF (NSUP.ANO.S) 6,5 
a IF(NSUP.ANO.I) 2,3 
2 RETURN 
6 ALN=Q 




C 


FETCH AN ASYNCHRONOUS SM FROM ACN=0 
CALL NETGETL(ALN,HA,TA,63> 




c 


FETCH PFCSFC AND STRIP OFF RB AND EB BITS 
PFCSFC=NFETCHUA,6LPFCSFC) .ANO. 777777777777777774778 
00 S L=l,20 
IF(SMIL) .EQ.999) GO TO 9 




c 


BRANCH ACCORDING SUPERVISORY MESSAGE CODE 






IFIPFCSFC.EQ..SMUIJ GO TO { 10, 20, 30,40,50 ,60,70,80 ,90 ,90 


,100), L 




8 CONTINUE 






9 PRINT *,* COULC NOT FINO SM IN TABLED 






PRINT 1000, HA, TA 




1000 FORMAT (» Hft =»,O20/» TA = »/63 (1X.O20/) > 






GO TO 3 




C 


PROCESS FC/ACK 
10 ACN-NFETCH(TA,5LFCACN) 




tf 


UPDATE FLOW CONTROL ALGORITHM 
NB(ACN)=NB(ACN)-1 
RETURN 




c 


PROCESS CON/REQ 
20 AGN=NF£TCHtTA,6LCONACN) 

ABLCACN)=NFETCH(TA,6LC0NABL) 
NB(ACN)=0 




c 


SET RESPONSE BIT TO ACCEPT THE CONNECTION 
CALL NSTOREtTA,2LRB»l) 




c 


CHECK IF APPL-TO-APPt CONNECTION 
IFCDT(ACN) .NE.240B) GO TO 21 




c 


SET ACT TO 1 (APPL-TO-APPL) 
CALL NST0RE(TA,6LC0NACT,1) 
GO TO 22 




c 


SET ACT TO DISPLAY COOE,10 CHARACTERS PER HORO 




c 


ASSIGN AL«. INTERACTIVE CONSOLES TO LIST 1 
CALL NST0REfTA,6LC0NALN,l> 
22 TAtl)=TA(l).AN0.77777400777700001777B 
HA=SMHOR 

CALL NETPUT (HA,TA> 
RETURN 




c 


PROCESS FC/INIT 
30 CALL NST0RE(TA,2LRB,1) 
ACN=NFETCH ( TA , 5LFCACN) 
HA=SMH0R 

CALL NETPUT <HA,TA> 
RETURN 




c 


PRXESS FC/8RK 
40 RC=NFETCH(TA,2lRC) 

ACN=NFETCH(TA,5LFCACN> 




c 


UPDATE FLOW CONTROL ALGORITHM FOR THIS CONNECTION 
N8tACN>=0 
HA=SMHOR 

CALL NST0RE(HA,6LABHADR,ACN) 
TAI1)*0 

CALL NST0RECTA,6LPFCSFC,FCRST) 
CALL NST0RE(TA,5LFCACN,ACN) 
CALL NETPUT (HA, TA) 
HAxOSHOR 
TA(1)=10H BYE BYE 





Figure 4-17. The ECHO Program (Sheet 3 of 4) 
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TA(2)=C 








CALL NoT0i<E(HA,6LA&HA0R,ACN> 








CALL OUTPT 








RETURN 




u 




PROCESS FC/STP 






50 


ACN=NFtTCH<TA,6LC0NACN) 
NB(ACN)=0 




c 




WAIT FOR AN INDICATION THAT TRANSMISSION CAN RESUfE 






51 


CALL N£THA1TU095,0> 
iF(NSUP.AND.S) 52,51 






52 


ALN=G 

CAtL NETGET(.<At.N,HA,TA,63> 

PFGSFC=NF£TCh(TA,6LPFCSFC> 

IF(PFCSFC.NE.FCSTA) CO TO 51 




c 




ISSUE REsEi SM TO RESTART THE TRANSMISSION 






10 


CALL NST0RE(TA,6LPFCSFC,FCRST) 

HA=SMHDR 

CALL NETPUT(HA,TA) 

RE TURN 




t» 




PROCESS FC/INA 






60 


ACN=NFETCH(TA,5LFCACN) 

HA=D$HOR 

CALL NST0Rt(HA,6LA8HA0f,,ACH) 




k» 




OUTPUT *TIME OUT* 
TA<1)=10H TIME OUT 
TA<2>=0 
CAtL OUTPT 
TAC1I=0 

CALL NST0RE(TA,6LPFCSFC,CONEN0) 
CALL NST0R£<TA,6LC0NACN,AGN1 
HA=SMHDR 

CALL N£TPUTCHA,TA> 
RETURN 




c 




PROCESS CON/CB 






70 


ACN=NFETCH(TA,6lCONACN> 

RC=NF£TCH<TA,2LRC> 

PRINT *,* CONNECTION BROKEN. ACN= *,ACN,* RC= #,RC 




u 




CLEAR ACTll/E CONNECTION INOICATOR 
A3L(ACN)=0 
RETURN 




c 




PROCESS FC/NAK 






SO 


ACN=NFETCH(TA,5LFCACN) 
A8N=NFETCH (TA,5LFCA8N> 
PRINT 1015,ACN,ABN 




1015 


FORMATS ACN = *,I6,» A8N = *,I10,» NOT OELIVERED») 








RETURN 




c 




PROCESS ERR/L&L AND SHUT/INSD 






90 


PRINT 1000, HA, TA 
CALL NETOFF 
STOP 666 
END 

SUBROUTINE OUTPT 




c 




OUTPUT ONE DATA BLOCK 
IMPLICIT INTEGER U-Z) 
COMMON K,L,I,S,NSUP,NSTAT,SHHOR,OSHDR,ASHOR 








COMMON CQNEND,FCRST,FCSTA,ACN,ABN,SM120> ,ABL (201 , NB<20> 


,MA,TA(63» 


c 




TEST ANO UPDATE FLOW CONTROL ALGORITHM 
IFINB(ACN>.GE.ABL(ACN») GO TO 5 
ABN=ACN»6'+ + K 

CALL NST0RE(HA,6LABHA8N,A3N> 
K=K*1 

NB(ACN)-NB(ACN>+1 
CALL N£TPUTCHA,TA) 
RETURN 






5 


PRINT ♦,* Aft . LIMIT HAS REACHED ON ACN = *,ACN 

RETURN 

END 





Figure 4-17. The ECHO Program (Sheet 4 of 4) 
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DATA FORMATS AND TERMINAL CONTROL 



THE INTERACTIVE VIRTUAL TERMINAL 

An interactive virtual terminal (IVT) is defined as a logical 
device that sends or receives logical lines of ASCII 
characters. These logical lines are transformed by the IVT 
interface software to physical lines of characters of the 
appropriate code set for the real terminal. IVT eliminates 
the application program of having to be concerned with 
which real terminals it is connected to and what specific 
characteristics they have (for example, line length, page 
length, control capabilities). IVT relieves the application 
from having to provide separate procedures in order to 
functionally service a variety of real terminals. 

The choice of functions provided by an IVT is deliberately 
restricted to ensure efficient implementation, even when 
transferring data to a real terminal with the lowest 
capabilities. The following IVT characteristics can be 
assumed by the application: 

• Infinite line width 

• Infinite page size 

• Use of the ASCII 128-character set 

When an application requires features that are not provided 
by the IVT, but known to exist on the connected real 
terminal, the application can perform the following 
functions: 

• Embed appropriate control characters in the output 
text, or scan for significant control characters in the 
input text. 

• Transfer data in transparent mode (in which case, the 
application has direct access to, and responsibility for, 
all real terminal features). 



characters involves a character-by-character conversion 
process, which significantly increases processing overhead. 



INPUT 

The line feed (LF) key signifies the end of a physical line, 
and when it is detected (or when the number of data 
characters reaches the page width defined for the real 
terminal), the preceding data is sent to the application as a 
BLK type block. (See section 2.) 

The carriage return (CR) key signifies the end of a logical 
line. When it is detected, the preceding data is sent to the 
application as a MSG type block. Either delimiter is 
discarded. 

A logical line compr ses a message; it can consist of one or 
more BLK blocks for every physical line, followed by a MSG 
block for the last line terminated by a CR. 

OUTPUT 

One or more logical lines can comprise a BLK or a MSG type 
block, subject to the restriction that a logical line cannot 
span block boundaries. 

The application terminates logical lines by one of the 
following: 

• A unit separator character (IF-,,) when using ASCII 
characters 

• 12 to 66 bits of binary zeros, right-justified in one or 
two 60-bit words, when using display code characters 

The user can also control output lines by using format 
effectors. 



IVT MODE TRANSFORMS AND 
FORMAT EFFECTORS 

As already explained, when working in IVT mode, logical 
lines are transformed by the IVT interface to physical lines 
of the appropriate code set, according to the real terminal 
characteristics. These are known as IVT mode transforms. 

These transforms are explained in greater detail in the 
following subsections. 

INPUT AND OUTPUT OPERATION 

ASCII is the recommended character type, although display 
code can be used. All 128 ASCII characters are valid, and 
the 7-bit ASCII characters are right-justified in either 8-bit 
or 12-bit bytes, as specified by the ACT field of the ABH. 
(See section 2.) The parity bit in both the 8-bit and 12-bit 
bytes is always set to zero by IVT transforms of the 
network. On output, NAM strips the upper 4 bits of the 
12-bit bytes and sets them to zero on input. When using 
display code characters, only the characters of the instal- 
lation character set are valid. They occupy 6-bit frames, 10 
characters per word. Note that the use of display code 



FORMAT EFFECTORS 

Format effectors are data characters that prefix each 
logical output line, but are not printed or displayed. They 
provide a means of achieving device-independent format 
control. 

Format effectors are the same for either ASCII or display 
code output. They are interpreted as follows: 

blank Space 1 line before printing (note 1). 

Space 2 lines before printing (note 1). 

Space 3 lines before printing (note 1). 

+ Position to start of the current line before 

printing. 

* Position to top of form or home cursor before 

printing. 

1 Position to top of form or home cursor, and 
clear the screen before printing. 

, Perform no action. 
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Space 1 line after printing. 

/ Position to start of the current line after 

printing. 

NOTE 

1. If the previous operation was input, the 
number of spaces is reduced by 1. 

2. Any characters other than the pre- 
ceding format effectors are treated as 
blanks. 

Format effectors do not exist if the no format effector 
(NFE) bit of the ABH word is set to 1. See section 5. 

LF and CR characters can be embedded anywhere within an 
ASCII output logical line. They are interpreted as follows: 

LF Cursor down one line. 

CR Return cursor to start of the current line. 

THE TRANSPARENT MODE 

Transparent mode can be seen as the opposite of IVT mode. 
In transparent mode, IVT transforms are inhibited; for 
example, all 256 possible 8-bit characters can be used 
without conversion or interpretation by the network 
software. 

While in transparent mode, the application has complete 
freedom and responsibility with regard to data formatting 
and terminal control; IVT format effectors, code conversion, 
and paging are not performed. Auto-input still applies, and 
page-waiting occurs on message boundaries. Transparent 
mode is selected differently for output and input operations. 

On output, it is selected by setting the transparent 
mode/IVT mode indicator (XPT) bit in the ABH word. The 
transparent mode is then in effect until TLC characters are 
transferred (see section 5). After that, normal IVT mode 
resumes. 

On input, it is selected either by the application program or 
by the terminal user. In both cases, transparent input mode 
is terminated by one of the three possible methods: 

• By a specific character code identification 

• By a character limit count 

• By a character timeout of 200 to 400 milliseconds 



The CTRL./DEF SSM is used to select and delimit trans- 
parent input data. (For further information, refer to 
section 5.) 

The parity bit, as selected by the parity (PA) option, 
determines the actual character codes received by the 
application. For a PA of N, all 256 8-bit character codes 
are received; for all other parity settings, the eighth bit is 
set to zero by the network. 



CHARACTER TYPE CONTROL 

When an application program changes its output character 
type, it changes the ACT field in the ABH to the appropriate 
character type. (See section 2.) When an application 
program changes its input character type, it sends the data 
control/change input character type (DC/CICT) supervisory 
message to NAM. (See appendix C.) The initial input 
character type is specified in the ACT field of the normal 
response to the CON/REQ SM. The format for the 
DC/CICT SM is shown in figure 5-1. The DC/CICT does not 
require a response from NAM. 



TERMINAL CHARACTERISTICS 

An application can redefine or modify certain terminal 
characteristics and parameters, where those of the 
connected real terminal differ from the assumptions made 
for the IVT mode. The application sends the CTRL/DEF 
(terminal characteristic redefinition) SM to NAM. It has the 
format shown in figure 5-2. 



SPECIFYING INDIVIDUAL CHARACTERISTICS 



The following character strings are used as terminal 
definition declarations. 

PW=nnn Specifies the physical page width of the 

terminal to be nnn decimal characters. 

On output, the network software advances the 
cursor to the beginning of the next physical 
line, where the number of characters trans- 
mitted equals the specified page width. 

The nnn parameter must be in the range of 
to 255, where nnn=0 means never advance to a 
new line as a result of a page width. 



acn 
act 




(Application to NAM) 
59 515049 43 35 23 


5 






DC 


E 
B 


ft 
B 


CICT 




DCACN 




ACT 


, 


c2 16 








00 8 





acn 





act 


The AC 
The ne 


IN from which i new character type input is requested. 
w character type code (as defined in section 2). 







Figure 5-1. Format for Change Input Character Type (DC/CICT) 
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ccc . . . 




59 515049 43 








CTRL 
"C1i6 


It. Elf. 
" 04b" 


ccc . . . c 




c A string of ASCII characters in the form: 






kk-param Also the form used for specifying terminal control commands. 






kk A two-character keyword called the terminal descriptor. 






param A parameter associated with the keyword to define a certain terminal characteristic. 





Figure 5-2. Format for Terminal Characteristic Redefinition (CTRL/DEF) 



PL=nnn Specifies the number of physical lines on a 

• page. On output, the network software 

advances the cursor to the next page when the 

number of physical lines transmitted equals 

the page length. 

The nnn parameter must be in the range of 
to 255, where means no paging is desired. 

PA=t Specifies which type of parity to expect on 

input, and which to generate on output. 
The t parameter can have the following 
values: 

Z Sets parity bit to zero. 

O Sets or checks for odd parity. 

E Sets or checks for even parity. 

N Is an information bit, no parity. 

The difference between PA equal to Z and PA 
equal to O or E is that for PA equal to Z, no 
parity check calculation is made and the bit 
must always be zero; for PA equal to O or E a 
parity check is made by the Network 
Processing Unit (NPU), but to the application 
the parity bit is always passed as a zero. The 
reason for this is to form the same ASCII 
character bit-pattern in memory, whether it 
comes from an even or odd parity terminal. 

On input operation, the eighth bit is not set to 
when PA is equal to N and while the 
operation is in transparent mode. In all other 
parity settings, the eighth bit is set to zero, 
regardless of the parity checking performed. 

BS=c Specifies c as the backspace character 

associated with the terminal. Whenever c is 
detected, the last character entered is deleted 
from the input buffer. The deleted character 
and the selected backspace character are not 
transmitted to the application. 

Bl=x Specifies x as the character for user break-1. 

It means that when x (QR) is sent by the user, 
it causes NAM to send to the application the 
FC/BRK SM, specifying that a user break-1 
has occurred. (See section 4.) 

B2=x Specifies x as the character for user break-2. 

It means that when x <@) is sent by the user, 
it causes NAM to send to the application the 
FC/BRK SM, specifying that a user break-2 
has occurred. 



CN=x 



PG=t 



Specifies x as the character to be used to 
cancel the input logical line in progress. It 
means that whenever x is entered as the last 
character of an input line (followed by a 
<£5fl[) ), and any portion of the logical line has 
already been sent to the application, a MSG 
block is sent with the cancel bit set. The 
application is notified to cancel the last 
entered input line. See section 5. 



The t parameter specifies whether or not 
page-waiting is in effect. It can have the 
following values: 

Y Page-waiting is in effect. 
N Page-waiting is not in effect. 



When output is sent to a CRT and page-waiting 
is in effect, the Terminal Interface Program 
(TIP) pauses its output display at each page 
boundary, and waits for any input followed by 
a (@) to be typed in, before it displays the 
next output page. 



If the page is not full and more output is 
available, OVER is displayed on the next 
available line. The next available output is 
displayed only after input followed by a <£g) 
is entered by the user. 

NOTE 

A null input line can be entered by 
the user; for example, when a page of 
output is to be acknowledged. In 
order to do so, the user must enter , 



or simply 



where x is the control character 
defined for the terminal. 

If page-waiting is in effect when the 
null line is entered, the line signals 
output acknowledgment only, and the 
line is not sent to the application. If, 
however, page-waiting is not in 
effect, the line is sent to the appli- 
cation as a MSG block. 
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Only one terminal control command can be specified for 
each CTRL/DEF SSM. If the PA and BS commands are 
needed, they are requested in separate supervisory 
messages. For example: 



59 


51 


5049 


43 


CTRL 








DEF 


PA = E 



followed by 

59 515049 



43 



CTRL 








DEF 


BS = * 



SELECTING TERMINAL CLASS 

In order to associate a terminal with a set of 
characteristics, a terminal class is specified. A terminal 
class is a number, 1 through 15, which identifies a specific 
physical terminal type, and associates it with a set of 
default terminal characteristics. There are 14 terminal 
classes and they are shown in table 5-1. 

TABLE 5-1. TERMINAL CLASSES 



Terminal 
Type 


Terminal 
Class 


M33 


1 


713 


2 


2741 


4 


M40 


5 


H2000 


6 


751 


7 


T-4014 


8 


HASP 


9 


200UT 


10 


214 


11 


711 


12 


714 


13 


731 


14 


734 


15 



Every class has its associated set of default terminal 
characteristics. For example, a few of the associated 
characteristics of the 713 terminal are as follows: 

PW (page width) = 72 

PL (physical number of lines) = 0, indicating an infinite 
page length 

PA (parity) = E 

BS (backspace character) =— 

Bl (user break -1 character) = : 

B2 (user break-2 character) = ) 

CN (cancel input line character) = $ 



For a complete list of terminal characteristics, refer to the 
NAM 1 reference manual. 

To select terminal class (TC), use the following command: 

TC=n Specifies the terminal as belonging, to terminal 
class n. 

For example, to select the 214 console, send 



59 


515049 


43 







CTRL 








DEF 


TC = II 



The device type (DT) is associated with the terminal class 
and is used to identify batch devices. The device type is an 
identifier passed to the application by the CON/REQ SM. 
(Refer to figure 3-4.) It is also used to identify application- 
to-application connections. Refer to section 6. 

The device type (DT) codes are as follows: 

Console 

1 Card reader 

2 Line printer 

3 Card punch 

4 Plotter 

5 Application-to-application 

NOTE 

The combined field of DT and TC in the 
CON/REQ SM is also called the device 
type, and is accessed by the CONDT 
keyword. (Refer to figure 3-4 and appen- 
dix B. ) 



SELECTING AND DELIMITING TRANSPARENT 
MODE INPUT 

The IN= descriptor is used for selecting the input device in 
either an IVT or transparent mode. The IN= parameters are 
as follows: 

KB Input device is a keyboard in IVT mode. 

PT Input device is a paper tape in IVT mode. 

XK Input device is a keyboard in transparent 

mode. 

XP Input device is a paper tape in transparent 

mode. 

If the transparent mode is selected, the next input operation 
is in transparent mode, until a transparent mode delimiter 
occurs. 

The delimiter is specified by 

DL=Xhh,Cnnnn,TO 

where: 

hh indicates two hexadecimal digits representing 

a delimiter that terminates transparent mode 
input. 
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nnnn indicates 1 through 4096 maximum character 
count for transparent mode. 

TO indicates input character timeout of 200 to 

400 milliseconds. 



NOTE 

At least one delimiter must be specified. 
If more than one is selected, transparent 
input mode is terminated by the delimiter 
that occurs first. 



Whenever terminal class (TC), page width (PW), or page 
length (PL) are redefined by the user, the application is 
notified of the change by NAM. NAM sends to it the 
TCH/TCHAR SM (terminal characteristics redefined) shown 
in figure 5-3. 

NOTE 

• Other redefinitions are not com- 
municated to the application. 



No response 
required. 



to TCH/TCHAR is 



TERMINAL CHARACTERISTICS CHANGED 
BY THE USER 



A terminal user can define or modify certain terminal 
characteristics. 



ABH FLAGS 

There is one set of flags applicable for input operation, and 
another set applicable for output operation. The flags for 
input are shown in figure 5-4; the flags for output are shown 
in figure 5-5. 



59 


515049 


43 




35 




23 


15 


7 







TCH 


li 


„ 


rCHAF 








ACN 


TC 


PW 




PL 




64 t6 








00? 









acn 


tc 


pw 




Pi 





ACN for which the user has redefined TC, PW or PL: 
tc Terminal class 
pw Page width 
pi Page length 



Figure 5-3. Format for Terminal Characteristics Redefined (TCH/TCHAR) 



:P£F 



CAN 



59 



2019 



141312 





I 




X 


C 


D 






B 




P 


A 


E 






U 




T 


N 


F 





Parity error flag: 

PEF=1 A parity error was detected in one or more input characters of the block transmitted. 

No parity error was detected. 



PEF=0 

Cancel flag: 

CAN=1 

CAN=0 



Indicates that the message being received on this connection has been cancelled by the terminal 
user; for example, one or more BLK blocks of the message were previously transmitted to the 
application, and have been discarded. 

Otherwise. 



Figure 5-4. Input ABH Flag Format (Sheet 1 of 2) 
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XPT Transparent mode/IVT mode indicator: 

XPT=1 Transparent mode, IVT transforms are inhibited. This mode is applicable to ACT 2 or 3 only. 

When an attempt is made to input in transparent mode and the ACT is not 2 or 3, the IBU bit 
sets, and the block is not transmitted. (See also IBU bit.) 

XPT=0 Normal IVT mode, transforms are in effect. 

IBU Input block undeliverable: 

IBU=1 An attempt was made to input a block which is larger than the maximum text area. (Refer to 

section 3). In such a case, the block is not transmitted, but rather remains queued within NAM 
until another AIP input call is performed, specifying enough length to accommodate the block. 

The true length of the block is found in the TLC field of the ABH. 

As mentioned in explaining the XPT bit, it is also set to 1 if transparent mode input is 
requested and the ACT is not 2 or 3. 

IBU=0 The block was transmitted to the text area. 



Figure 5-4. Input ABH Flag Format (Sheet 2 of 2) 



AIM 



PBC 



XPT 



NFE 



59 


19 1615141312 









N 


X 


P 


A 








F 


P 


B 


I 








E 


T 


C 


M 





Auto input mode indicator: 

AIM=1 Auto input mode is requested. It means that this data block is to be sent to a terminal as 

output, and its first 20 characters are to form the subsequent input from that terminal. The 
output block must be an ABT of 2 (other ABTs are ignored). The block can be output in 
transparent mode, but the corresponding input block is not transparent, unless explicitly declared. 

AIM=0 Otherwise, normal mode. 
Punch banner card: 

PBC=0 Otherwise, no punched banner card is requested. 

Transparent mode/IVT mode indicator: 

XPT=1 Specifies the block to be output is in transparent mode, in which case IVT transforms are 

inhibited. Normal IVT mode resumes after TLC characters have been transferred. The XPT=1 
is ignored if ACT is not 2 or 3. 

XPT=0 Normal IVT mode, transforms are in effect. 

No format effectors. Applies to data in an IVT mode only. 

NFE=1 Specifies that no format effectors are to be associated with the data block. The output line is 
single-spaced before printing, and the first character is printed or displayed. 

NFE=0 Format effectors are present in the output data block (for example, the line is spaced according 
to the first character, which is not printed or displayed). 



Figure 5-5. Output ABH Flag Format 
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MISCELLANEOUS FEATURES 



In this section, the following miscellaneous features of NAM 
are presented: the parallel mode, fragmented buffer 
routines, application-to-application communication, the 
debug option, and the statistical option. 



THE PARALLEL MODE 

In its normal mode of operation, NAM returns control to the 
calling application only after a full completion of the 
requested operation has occurred. In the parallel mode, 
however, the application can continue execution before the 
last NAM request has been completed. 



To check the status of the last request, NAM sets the flag 
bits in the nsup word. NAM checks the c bit in the nsup 
word for parallel mode processing. 



To select the parallel mode of operation, call the NETSETP 
routine: 

CALL NETSETP (0) 



To terminate the parallel mode of operation, call the 
NETSETP routine: 

CALL NETSETP (1) or any other value not equal to 

In parallel mode, NETCHEK must be called before checking 
the c bit: 

CALL NETCHEK 



NETCHEK performs two functions: 

It updates the c bit in the nsup word. See figure 6-1. 

It attempts to reissue the previous call to AIP if it was 
rejected by NAM. 

If the c bit is not set, NETCHEK must be called to reflect 
the status of the last request. While the c bit is not set, 
only NETCHEK or NETWAIT calls are allowed. 



NETCHEK must be called and the c bit checked for a 
completion status before any of the following routines or 
NETWAIT can be called in again: 

NETGET 

NETGETL 

NETGETF 

NETGTFL 

NETPUT 

NETPUTF 

When NETWAIT is called in parallel mode, the program is 
suspended and the parallel mode of operation is ignored. 
The parallel mode is reinstated when the NETWAIT call is 
completed. 

Sample program EASY, as shown in figure 6-2, provides an 
example of parallel mode operation. 



THE FRAGMENTED BUFFER ROUTINES 



The fragmented buffer routines perform data transfer from 
a buffer that is split into fragments. 

Data for input is split into independent fragments. Data for 
output is gathered from the fragments to constitute one 
complete block. The fragmented buffer routines are 
NETGETF and NETGTFL for input, and NETPUTF for 
output. They are in all respects similar to NETGET, 
NETGETL and NETPUT, respectively; only their text area is 
split into fragments. 

There can be up to 40 fragments each having its own length 
as chosen by the application. 

The independent fragments make better use of memory 
space. They gather memory space that is created when 
messages are processed in a different order than they have 
arrived. Although every fragment has its own length, 
situations of a variable size buffer management processing 
are rare. Therefore, the fragmented buffer mechanism is 
recommended for applications using a pool of fixed length 
buffer areas. 





5958575655 






c 














The' c bit is applies 
c Complete 

1 = Last 
= Othe 


ible only when working in the parallel mode, and its meaning is: 
bit: 

NAM call has been completed 
rwise 





Figure 6-1. NSUP Word Parallel Mode Bit 
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The changes made are marked by shading: 

PROGRAM EASY (OUTPUT) 
INTEGER PFCSFC,CONREQ,FCINIT,S,C 
INTfcGER SMH0R,0TH0R,HA,TA<63> 
C SET UP CONSTANTS 

SMHDR=0 

CALL NST0RE<SMH0R,6LA9HABT,3> 
CALL NSTORE<QTH0R,6LA8HACT,l> 
CALL N5T0RE(SHH0R,6LABHTLC,1> 
DTHCRsO 

CALL KST0RE(CTHQR,6LABHABT,2> 
CALL NSTOREC0THDR,6LABHACT,*> 
CALL NSTORE(0TH0R,6LABHTLC,10> 
CONREQ=NFET CH ( 0, 6LC0NREQ) 
FCINIT=NF£TCHC0,6LFCINIT) 
S=SHIFTI1,55> 
I = SMFT(1,56> 
C = SMIFT<1,59> 

CALL NETON(5HMVAPP,NSUP,NSTAT,1,10) 
IF (NSTAT.EQ. 0) GO TO 4 
PRINT 100.NSTAT 

100 FORMAT (♦NETON FAILE0,NSTAT=»,O20> 
CALL NETOFF 

STOP 111 

". ■ .... •■■: T i.= TP I ■': -• Enter parallel mode 

I- CALL NFTfHFK \ 

.- r "t *,' up * u •.-,-.. > •* — Update and then check the complete bit 

"; ' \ , The complete bit is not set. Meanwhile 

• > some other processing may be performed. 

1 GO TO 5 ' 

2 CALL NETHAITC W95.0V"" ~- The complete bit is not set. (NETWAIT 

C CHECK FOR A SUP. MESSAGE OR INPUT AVAILABLE is called to update the S and I bits) 

IF CNSUP .AND.S) 6,3 

3 IF (NSUP.ANC.I) 20,5 

C SUPERVISORY MESSAGE IS AVAILABLE 

6 CALL NET GET <0,HA,TA,63> 
PFCSFC* NFETCHI TA , 6LPFCSFC > 

IF tPFCSFC.EQ.COHREQ) GO TO 7 
IF CPFCSFC.EQ.FCINITJ GO TO « 
PRINT 101,HA,TA 

101 FORMAT ("UNKNOWN SUP. MESSAGE »/6W IX ,020/1 1 
CALL NETOFF 

STOP 222 
C CON/REQ PROCESSING 

7 ACN=NFETCH<TAi6LCbNACNI 
CALL NST0RE(tA,2LRB,l) _ 
CALL NST0RE(TA,6LC0NACf,3) 
HA=SMHOR 

4« call -serc-Et 

IF(NSUP.ANQ.C) «,*2 

GO TO <»0 
*>3 CALL NETPUTCMA,TA) 

• 

GO TO 5 
C FJB/IMIT PR OCESSING 

8 ACN=NFETCH (TA .5LFCACNJ 
CALL NSTORECTA,2LRB,l> 

HAxSMHOR 
■■ ,4i I NETCHEK 

IF(NSUP.AND.C) 11,10 

GO TO 9 

Figure 6-2. Sample Program EASY in Parallel Mode (Sheet 1 of 2) 
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11 CALL NETPUT(HA,TA» 

• 

TA=10H INPUT PLS 

HA=OTH0R 

CALL NST0RE(HA,6LABHACN»ACN) 

12 CALL NcTCHEK 
IF(NSUP.ANO.C) 14,13 



GO TO 12 
13 CALL NETPUT(HA,TA> 
GO TO 5 

INPUT IS AVAILABLE 

20 CALL NETCHEK 
IFCNSUP.ANO.C) 22,21 

21 GO* TO 20 

22 CALL NETGETfACM,HA,TA,l) 

END 



Figure 6-2. Sample Program EASY in Parallel Mode (Sheet 2 of 2) 



The fragmented buffer mechanism is achieved by trans- 
nitting to NAM a vector that contains the size and address 
jf every fragment. The format of this vector is shown in 
Figure 6-3. An example of the memory allocation technique 
s shown in figure 6-4. The following section provides a 
description of fragmented buffer routines. 



NETGETF 

The NETGETF routine inputs one data block or a supervisory 
nessage from the specified connection. 

The application block header is placed in the specified 
leader area, and the body is . placed in the supplied 
xagmented buffer. If blocks are not available for this 



connection, a null block is returned, a header with an ABT 
of is placed in the header area, and the fragmented buffer 
remains unchanged. 

The format of NETGETF is 

CALL NETGETF (acn,ha,n,va) 



where: 
acn 

ha 



indicates the ACN identifying the connection 
from which data is transferred (ACN of is 
also allowed). 

indicates header area for ABH. 



59 




38 


29 




17 










size.) 





add-j 





size2 





add2 






size n 





add n 



sizej is the length in central memory words of the i-th fragment, 

addj is the address of the i-th fragment. 



Figure 6-3. Format for Fragmented Vector 
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6-3 



indicates the number of buffer fragments 
described in va (up to a maximum of 40). 

indicates the vector area containing address 
and size, in central memory words, of every 
fragment. 



NETGTFL 



The NETGTFL routine selects the next connection from th< 
specified list that has input available, and inputs from it oni 
data block or a supervisory message. 



10 



1000 



1200 



3200 





12 




4600 



3200 



1000 



10g word buffer 



1200 



4600 



5 word buffer 



3 word buffer 



123 word buffer 



Figure 6-4. Example of Memory Allocation Technique 
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The header of the block is placed in the specified header 
area, and the body of the block in the supplied fragmented 
buffer. The null block is returned only if there is no input 
available for all the connections in the specified list. If the 
null block is returned, a header with an ABT of is placed in 
the header area, and the fragmented buffer remains 
unchanged. 

The format of NETGTFL is 

CALL NETGTFL (aln,ha,n,va) 

where: 

aln indicates the ALN from which connections are 

selected, and data is transferred. 

ha,n,va serve exactly the same purpose as with 
NETGETF. 



For all fragmented buffer input routines, if the length of the 
block exceeds the sum of the size values in the vector area, 
the block is not transmitted, but instead remains queued 
within NAM. The IBU bit of the ABH is set to 1, and the 
true length of the block is placed in the text length (TLC) 
field of the ABH. 



NETPUTF 

The NETPUTF routine outputs " one data block or a 
supervisory message to the specified connection from the 
fragmented buffer area, according to the information 
contained in the header area. 

The format of NETPUTF is 

CALL NETPUTF (ha,n,va) 

where: 

ha,n,va serve exactly the same purpose as with 
NETGETF. 



APPLICATION-TO- APPLICATION 
COMMUNICATION 

An application can connect to another application by sending 
NAM the CON/ACRQ SM. NAM validates the request and 
establishes the connection with both applications. 

The supervisory message dialog shown in figure 6-5 is used 
when application A requires connection to application B. 
The format for requesting an application connection is 
shown in figure 6-6. If NAM can establish the connection, a 
CON/REQ SM is sent to both applications. If, however, the 
requested application is not available, an abnormal response 
is sent to the requesting application. See figure 6-7. 

To demonstrate an application-to-application communica- 
tion example, the application program MONIT is shown in 
figure 6-8. This program connects the ECHO program, and 
writes into the output file all output sent by ECHO. In order 
to do this, the ECHO program is slightly changed to 
recognize and accept application-to-application connections, 
and send its echoed output to the monitoring applications. It 
is possible that more than one application monitors ECHO. 
In fact, different copies of MONIT (with unique application 
names passed at NETON time) can concurrently run and 
monitor ECHO. 



ECHO identifies ah application-to-application connection by 
testing the device type (DT) field of the CON/REQ SM. 
(Refer to figure 3-4. ) 

The OUTPT routine is also changed to send output to the 
monitoring applications which are currently connected to 
ECHO. The output sent by OUTPT is shown in figure 6-9. 

MONIT issues a CON/ACRQ SM and waits for NAM to 
establish and enable the connection. 



Application A NAM 

-. CON/ACRQ -*■ 



Application B 



- CON/REQ - 



CON/REQ 



CON/REQ/N 



CON/REQ/N 



FC/INIT 



FC/INIT 



FC/INIT/N 



FC/INIT/N 



In this case a connection was established and enabled 
between application A and application B, input and out- 
put can be exchanged. 

If application B is not available, NAM rejects the 
CON/ACRQ by: 



Application A NAM 

CON/ACRQ — ■— 

■m CON/AC RQ/A 



Application B 



and the connection is not possible. 
The connection can also be rejected by application B: 
Application A NAM Application B 

CON/ACRQ — 

CON/REQ - 

— CON/REQ 



CON/REQ/A 



Appl. B 



CON/REQ/N 
— CON/CB — 



rejects 

the 

request 



-CON/END *- 



CON/EN D/N 



Data between the two applications can be exchanged 
using an ACT of 1 only. 



Figure 6-5. Application-to-Application Communication 
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59 


51 5049 


43 


17 





CON 


B 


H 
B 


ACRQ 




63 1§ 








02o 




CONANM 




aname 





aname Requested application's name, one through seven alphanumeric characters with the first character being 
alphabetic, left-justified and blank-filled. 



Figure 6-6. Format of Request Application Connection (CON/ ACRQ) 



re 



59 


515049 


43 


35 


17 





CON 


B 


H 
B 


ACRQ 


RC 




6316 


1 





02 8 


re 




CONANM 




aname 





Reason code for rejecting the request: 

1 = aname is not available, which might be because: 

• There is no such application name in the LCF file (see appendix D) 

• The requested application is not currently in the system 

• The requested application has exceeded its defined connection limit 

2 = Shutdown is in progress. 

3 = The requesting application has exceeded its defined connection limit. 



Figure 6-7. Format of Request Connection Reject (CON/ACRQ/A) 



PROGRAM MONIT (OUTPUT* TAPED 

MONIT PROGRAM IS AN APPLICATION-TO-APPLICATION 
COMMUNICATION EXAMPLE WHICH MONITORS ALL THE OUTPUT 
SENT BY THE ECHO PROGRAM. 

IMPLICIT INTEGER <A-Z> 

DIMENSION SH<6>,TX(3t f TA<10),XX<53) 

INITIALIZE AND SET CONSTANTS 

K=0 

TXC1)=TX<2»=0 

SHHDR=03 000000000004000 0018 

S ANO I ARE NSUP NORO MASKS 
S=SHIFT(1,55) 
I=SHIFT(1,56) 

SET OUTGOING SM CONSTANTS 
CONACR=NFETCH C 0,6LCONACR> 
CONEND=NF£TCH( O v 6L20NENO) 

CONSTRUCT CON/ACRQ SM TEXT AREA 
CALL NStORE(TX,6LPFCSFC,CONACR> 
CALL NST0RE(TX,6LC0NANM,7RTAPPL<» ) 



Figure 6-8. Application-to-Application (ECHO— MONIT) (Sheet 1 of 7) 
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C 6UIL0 SUPERVISORY MESSAGE BRANCHING TABLE 

SM(l)=NFETCH(0,6LCONREa> 
j>MC2)=NFETCHCQ»6LF3INIT> 
SM (3) =NFETCH(0 ,6LC0NACR> 
SMU> = NFETCH(0,5LCONCB> 
SN<5)=NFETCH<0,6LERRLGL> 
SM(6>=NFETCH(0,6LSHUINS» 

C ESTABLISH NETWORK ACCESS 

CALL NET0M7HTAPPL*A,NSUP, NSTAT,t,l> 
iF(NSTAT.EQ.O) GO TO 1 
PRINT iOO.NSTAT 

100 FORMAT (♦ NSTAT - »,O20) 
STOP 111 

C 

- SENO CON/ACRQ TO APPL. ECHO 

1 HA=SMHOR«-l 

2 CALL N£TPUT(HA,TX> 

3 CALL NETWAITC5,0J 
u 

(, TEST FOR A SUPERVISORY MESSAGE OR A DATA INPUT AVAILABILITY 

3 IF(NSUP.AND.S) k,b 

o IF(NSUP.ANO.I) 22,3 

<♦ CAuL N£TGET<0,HA,TA,63) 

- LOOK FOR A SUPERVISORY MESSAGE 

C 

c 

& FETCH PFCSFC AND STRIP OFF RB AND EB BITS 

PFCSFC=NF£TCH<TA,6LPFCiFC> .ANO. 77777777777777777*779 
00 5 L*l,6 

IFCSMCD.EQ. PFCSFO GO TO CIO, 20, 30, <»0, 50, 60) ,L 
5 CONTINUE 

PRINT ♦, * COULD NOT FIND SM IN TABLE* 
PRINT 101,HA,TA 

101 FORMAT!* HA = ',020/* TA = */10C lX,O20/> ) 
GO TO 3 

» PROCESS CON/REQ. ACCEPT ONLY AN APPLICATION CONNECTION 

u 

10 HA=SMHOR 

a IF OEVICE TYPE * 5 IT IS AN APPLICATION CONNECTION 

IF (NFETCH(rA,5LCONOr>-Z<tOB) 12,11 

11 ACN=NF£TCH<TA,6LC0NACN> 
TA(1>=TAI1) .ANO. 77777*007777000000008 
CALL NST0RE(TA,2LRB,1I 

CALL NST0R£{TA,6LC0NACT,1I 

CALL NETPUT(HA,TA) 

GO TO 3 
C 
C REJECT THE CONNECTION 

12 CALL NSTGR£(TA,2LE3,1> 
CALL NETPUt(HA,TA> 
CALL NETOFF 

STOP 333 

a 

C PROCESS FC/INIT 

20 CALL NST0RE(TA,2LR3,1> 
ACN-NFETCH(TA,5LFCACN) 

HA=SMHOR 

CALL NETPUT(HA,TA) 

21 CALL NETWAITC*095,0> 



Figure 6-8. Application-to-Application (ECHO-*MONIT) (Sheet 2 of 7) 
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; CHECK IF INPUT IS AVAILABLE 

IF {NSUP.ANO.D 22t9 
22 CALL NETGETWCN,HA,TX,3> 
Adr=NFETCH(HA,6LABHAaT) 

IF(ABT.N£.3) GO TO 23 ,.„,„ „„ „„,.. „ » rkl 

PRINT »,* 5H RECEIVED WHEN INPUT OATA WAS EXPECTtO ON ACN =*,ACN 
PklNT 101,HA,TA 
&0 TO 3 
2 3 ACNl=NFETCHCTX(2),6LA8HAuR> 
PRINT 102,TIME<M),iX,ACNl 
182 FORMAT (IX, 2A10,» HA = »,020,» TA = »,A10,»S£NT TO ACN =»,I<0 
GO TO 9 

C PROCESS CON/A2R 

C 

30 IFCNFETCH<TA,2LE8>-1> 3,31 

; CON/ACRQ REJECTED. WAIT 30 SECONCS AND TRY AGAIN 

31 IF(NFETCH<TA t 2LRC)-l> 33,32 

32 PRINT »,* CON/ACRQ REJECTED* 
PRINT 101,HA,TA 

L-ALL NETHAIT(30,1) 

K=K»1 

IF CK.LE.7) GO tO 1 

33 CALL NET OFF 
STOP 777 

C PROCESS CON/CB 

VQ ACN=NF£TCH«TA,6LC0NACM> 

PRINT *,* CONNECTION BROKEN* 
PRINT 10i,HA,TA 
CALL NETOFF 
STOP 222 

C PROCESS ERR/L6L 

b 

50 PRINT »,* LOGICAL ERROR* 
PRINT 101,HA,TA 
CALL NETOFF 
STOP 333 

C PROCESS SHUT/INSO 

C 

60 PRINT ♦,* HOST SHUT OOHN* 

PRINT 101,HA,TA 

CALL NETOFF 

STOP >*V* 

ENO 



The changes made in ECHO are shown by the shaded lines: 

PROGRAM ECHOfOUTPUn 
C LOOP BACK TEST DEMONSTRATION PROGRAM 

IMPLICIT INTEGER CA-Z» .«.„«„ »«.,« 

COMMON K,L,I,S,NSUP,NSTAT,SMHOR,OSHOR,ASHOR f *W« _..-„ 

' | f FCRST,FCST« f ACN,ABN,SMC20»,ABH2«l,MBCZ0),HA,T»C63> 



C INITIALIZE ANO SET CONSTANTS 

C K IS THE APPLICATION BLOCK NUMBER COUNTER 

K«l 
C S ANO I ARE NSUP MORO FIELO MASKS 

S'SHIFTU, J5) 
I*SHIFT<1,56) 
DO 15 LL=1,20 



Figure 6-8. Application-to-Application (ECHO— MONIT) (Sheet 3 of 7) 



6-8 



60480400 A 



15 ABLUL) = NB<U.)=OT<LU*a 
C SHHDR - SUPERVISORY MESSAGE HEADER CONSTANT 

C DSHOR - DXSLAY GOOF. OUTPUT H£AO££ C3fiS?*.Tf c ^: Win BLOCK 

C APrtDR - APPLICATION-TO-APPlIGATION cgmnunication heaoer constant 

SHHOR =0300000000000i.OD0001B 

OSHOR =020 000000000200000246 

APHDR-OIOOOOOOOOOOOMJOOOOSB 
5 SET APPL. TO NAM SH CONSTANTS 

CONEND=NF£TCH(0»6L3ONENO> 

FCRST -NFETCH(0,5LFCRST> 

FCSTA=NFETCH(0,5LFCSTA) 
C BUILO A BRANCHING TABLE FOR SUPERVISORY MESSAGES 

SM(1>*NFETCH(0,5LFCACK> 

SH(2>*NFETCH(0,6LCONREQ> 

SM(3)=NFETCH(Q,6LF5INIT> 

SMU)-NFETCH(0,5LFCBRK> 

SM(5)=NF£TCH(Q,5LFCSTP} 

SN(6>=NFETCH(0,5LF3INA> 

SM{7)=NF6TCH(0,5LCONDB> 

SH(8)=NFETCH(0,5LFCNAK) 

SH(9)=NF£TCH(0,6LERRLGL> 

SM (10 1 =NF£TCH < 0, 6LSHUINS) 

SN(11I=NFETCH(0,5LFCSTA> 

SN (12) «999 
S ESTABLISH NETWORK ACCESS 

CALL NETON(6HTAPPL<t,NSUP,NSTAT,l,20> 
tt TEST FOR NETON ACCEPTANCE 

IF (NSTAT.EQ.O) GO TO 5 

PRINT 100,NSTAT 
10 FORMAT (» NSTAT = ♦,020> 

STOP 111 
5 CALL LOOKS M 

GOTO (5,5, <»0, 5,5,5,5,5,5,5,5,999) ,L 
C INITIALIZE CONNECTION BY SENDING OUTPUT 

tO HA=OSHOR 



CALL NST0RE(HA,6LABHADR,ACN) 
TA(1)*10H INPUT PLS 
TA(2I=0 
CAcL OUTPT 
GO TO 5 
999 ALN=1 

CALL NET6£TL(ALN,HA,TA,63) 

AST »NFET CH (HA, 6LABHA8T) 

ACT*NFETCH(HA,6LABHAGT> 

AGN*MFETCH (HA, 6LABXA0R> 

TLC*MFETCH (HA , 6L ABHTLC » 
C BRANCH TO PROCESS A OATA BLOCK 

IF (ABT .NE. 3» GO TO 6 

PRINT V* SN RECEIVED WHEN INPUT OATA NAS EXPECTED ON A6N **,ACN 

PRINT 101,HA,TA 
101 FORMATS HA * »,O20/» TA « V63(lX,020/> > 

GO T0 5 
6 HA*HA.ANO. 777777777 7777*00 7777B 
C TEST FOR TEN DISPLAY CODE ZEROES HHICH SIGNAL END OF ECHO RUN 

IF(TA(l>.EQ.lOH000aO00000i 60 TO 555 
S CHANGE BLOCK TYPE TO BLK BLOCK 

CALL NSrOR£(HA,6LA3HA8T,l> 
C INHIBIT FORMAT EFFECTORS 

CALL NST0RE(HA,6LABHNFE,1> 
C ECHO INPUT AS OUTPUT,AFTER ADOING A UNIT SEPARATOR 

C FOR AST**, DISPLAY CODE, THE UNIT SEPARATOR MUST BE 12 BITS 

C OF ZERO RIGHT JUSTIEO. I.E. IF THERE IS ONE OR ZERO CHARACTER 

5 POSITIONS REMAINING (XTRA> THEN ANOTHER MORO OF ZEROS HILL BE 

C AODEO. 

FULHD*TLC/1Q 

XTRA=TLC-10»FULHO 

ZFILL*10-XTRA 



Figure 6-8. Application-to-Application (ECHO—MONIT) (Sheet 4 of 7) 
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TLC=TLC+ZFILL 

MASK=77000000000000000Q008 

IF(XTRA.EQ.O)TA(FULHO*1>=0 

TACFULH0*l)=TA(FULHO*l>.ANO.SHIFT(MASK,-(6»XTRA)> 

IF(ZFILL.NE.l) GO TO 71 

TLC=TLC+10 

TA*FULH0»2)=Q 
71 CALL NST0RE<HA,6LABHTLC,TLC) 

CALL OUTPT 

CALL LOOKSM 

60 TO <«»0,5,<»0,5,5,5,5,5,5»5,5,999)»L 

SEND CON/END TO ALL ACTIVE CONNECTIONS 
555 TA(1)=0 

CALL NST0RE(TA,6LPFCSFC,C0NEND) 

HA=SMHDR 

00 556 LL=1,20 

IF(ABLILL) .EQ.S) GO TO 556 

CALL NST0RE<TA,6LCQNACN,LL> 

CALL NET PUT (HA, TA) 
956 CONTINUE 

CALL HETOFF 

STOP 777 

END 



The LOOKSM changes are shown by the shaded lines: 

SUBROUTINE LOOKSM 
C PROCESS ASYNCHRONOUS SUPERVISORY MESSAGES 

IMPLICIT INTEGER CA-ZI 

COMMON K,L,I,S,NSUP,NSTAT,SHHOR,OSHOR,ASHOS 
COMMON CONENO,FCRST,FCSTA,ACN,ABN,SM(20> ,ABL<20),NB<20>, HA,TA(63> 



L*12 
; CHECK FOR OUTSTANDING SUPERVISORY MESSAGES 

IF(NSUP.ANO.S) 6*3 
i PAUSE FOR INPUT DATA OR A SUPERVISORY MESSAGE 

3 CALL N£TMAIT(<»O95,0) 

IF (NSUP.ANO.S) 6,5 

5 IF(NSUP.AND.I) 2*3 
2 RETURN 

6 ALN'O 

! FETCH AN ASYNCHRONOUS SM FROM ACN*0 

CALL NETGETL(ALN,HA,TA,63> 
J FETCH PFCSFC AND STRIP OFF RB ANO E8 BITS 

PFCSFC*NF£TCH(TA,6LPFCSF«.AN0. 77777777777777777*778 

00 8 L*l,20 

IFtSMCL) .EQ.999) GO TO 9 
: BRANCH ACCORDING SUPERVISORY MESSAGE COOE 

IF (PFCSFC. EQ.SM(D) GO T0( 10, 20, 30, M ,50 ,60,70,80 ,90,90,100) ,L 
B CONTINUE 

9 PRINT ♦,* COULD NOT FIND SH IN TABLE* 
PRINT 1800, HA, TA 
1080 FORMATS HA =»,O20/» TA * V63C1X, 020/) ) 
GO TO 3 
S PROCESS FC/ACK 

10 ACN=NFETCH(TA,5LFCACN> 
B UPDATE FLOM CONTROL ALGORITHM 

N6(ACN)sNB(ACN)-l 
RETURN 
5 PROCESS CON/REd 

2 ACN=NF£TCH (TA, 6LC0NACN) 

A8L (AC N) =NF£TCH (TA, 6LC0NAB L) 

N8(ACN)=0 __„ ^ 

C STORE DEVICE TYPE (FOR IDENTIFYING LATER AN APP-TO-APP CONNECTION) 

BT(ACN)=NFE?Ch(TA,5LCONOT) : ' 

2 SET RES 3HSE BIT TO ACCEPT THE CONNECTION 

CALL NST0RE<TA,2LRB,1) 
C CHECK IF APPL-TO-APPL CONNECTION 



Figure 6-8. Application-to-Application (ECHO— MONIT) (Sheet 5 of 7) 
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1FJ0UACNI .NE. 24081 GO TO 21 

SET ACT TO 1 (APPL-TQ-APPL) 
CALL NST0R£(TA,6LC0NACT,1> 
GO TO 22 

SET ACT TO OISPLAY COOE, 10 CHARACTERS PER WORD 
21 CAcL NST0R£<TA,6LC0NACT,h> 

ASSI4W «.t-l IH?£RAEIIi/E CONSOLES TO LIST 1 
CALL NST0RE(TA,6LC0NALN,1> 
22 TA<1)=TA(1) .AND.7777740O7777OOOO1777B 
HA=SMHOR 

CALL NETPUT <HA»TA) 
RETURN 

PROCESS FC/INIT 
30 CALL NST0RE(TA,2LRB,i> 
ACN=NFETCH (TA, 5LFCACN) 
HA=SHHOR 

CALL NETPUT (HA, TA) 
RETURN 

PROCESS FC/BRK 
<»0 RC=NFETCH(TA,2uRC) 

ACN=NFETCH<TA,5LFCACN> 

UPDATE FLOW CONTROL ALGORITHM FOR THIS CONNECTION 
NB<ACN)=0 
HA=SMHOR 

CALL NST0RE(HA,6LABHA0R,ACN) 
TAU)=Q 

CALL NST0RE(TA,6LPFCSFC,FCRST> 
CALL NSTOREUA,5LFCACN,ACN) 
CALL NETPUT (HA, TA) 
HA-OSHOR 

TA(1)=10H BYE BYE 
TA(2)=0 

CALL NSTORE<HA,6LA3HAOR,ACN) 
CALL OUTPT 
RETURN 

PROCESS FC/STP 

50 ACN=NFETCH(TA,6LCONACN) 
NB(A0N)=Q 

WAIT FOR AN INDICATION THAT TRANSMISSION CAN RESUME 

51 CALL NETHAIT«»095,0) 
IF(NSUP.ANO.S) 52,51 

52 ALNsO 

CALL NETGETL(ALN,HA,TA,63) 
PFCSFC=NF£TCH(TA,6LPFCSFC> 
IF(PFCSFC.NE.FCSTA) GO TO 51 

ISSUE RESET SH TO RESTART THE TRANSMISSION 
10 CALL NST0RE(TA,6LPFCSFC»FCRST> 
HA*SNHDR 

CALL NETPUT (HA ,TA) 
RETURN 

PROCESS FC/INA 
SO ACNsNF£TCH(TA,5LFCACN) 
HA=OSHOR 
CALL NST0RE(HA,6LAaHA0R,ACN) 

OUTPUT #TIHE OUT* 
TA(1)=10H TINE OUT 
TA(2)=0 
CALL OUTPT 
TA(U=0 

CALL NSTORE(TA,6LPFCSFC,CONEN0) 
CALL NST0RE(TA,6LC0NACN,ACN) 
HA=SMHOR 

CALL NETPUT (HA, TA) 
RETURN 

PROCESS C0N/C8 
70 ACN=NFETCH(TA,6LC0NACN) 
RC=NFETCH(TA,2LRC) 
PRINT ♦,< CONNECTION BROKEN. ACN- *,ACN,* RC= *,RC 

CLEAR THE DEVICE TYPE 
OT«ACN)=0 
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£l£A» ACT1WE CONNECTION INDICATOR 
A8L(ACN>=0 
RETURN 
; PROCESS FC/NAK 

8 ACN=NFtTCH<TA,5LFCACN> 
ABN=NF£TCH {TA,5LFC»8N> 
PRINT 1015, ACN, ABN 
1C15 FORMAT (♦ ACN - *,I6#» ABN = »,I10,» NOT OELXVEREO*) 

RE* URN 
; PROCESS ERR/LGL ANO SHUT/I NSD 

30 PRINT 10 00. HA, TA 
CALL NET OFF 
STOP 666 
END 



The OUTPT subroutine changes are shown by the shaded lines: 

SUBROUTINE OUTPT 
S OUTPUT ONE DATA BLOCK 

IMPLICIT INTEGER <A-Z> 

COMMON K,L,I,S,NSUP t NSIAT,SMHOR,DSHOR,ASHORj 
COMMON CON£NG,FCRST,FCSTA, ACN, ABN, SMI20) »A8t 



(,N8(2Q>,HA,TA<63» 




"THFTFP6ATE FLOW CONTROL ALGORITHM 
IF(N8(ACN>.G£.ABL<ACN)> GO TO 5 
A8N=ACN»64+K 

CALL NST0R£<HA,6LA8HABN,A3N> 
K=K*l 

N6(ACN)=NB(ACN)*1 
CALL NETPUT(HA.TA) 
SEND ECHOED OUTPUT TO ALL HCNITORING APPLICATIONS 

txi2>=ha 
tx(3)=ta<i> 

hx=aphor 
ao 10 jai,?o 

IF<0?U»»NE.2%OB»OR.NB<J)«GE.ABL(J>» GO TO 10 
NdUt-NetJ)»l 

CAU NST0RE<HX,6LABHA0ft, I) 
CALL N£TPUT(HX,TX) 
10 CONTINUE 

5 PRINT *,* ABL LIMIT HAS REACHEO ON ACN -#,ACN 
RETURN 
ENO 



Figure 6-8. Application-to-Application (ECHO— MONIT) (Sheet 7 of 7) 



hh.mm.ss 


ABH 


CCC...C 



word 1 



word 2 



hh.mm.ss The time this message was sent to a terminal. 

ABH The original ABH sent to a terminal, 

c c c . . . . c The echoed characters sent to a terminal. 



word 3 



Figure 6-9. Output Sent by OUTPT 
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If CON/ACRQ is rejected, MONIT checks the reason code 
(RC). If RC is 1 (for example, ECHO is probably not 
currently in the system), MONIT reissues the request again 
in 30-second intervals, up to seven times. If RC is not equal 
to 1 or 7, CON/ACRQ SMs are rejected and MONIT 
NETOFFs. If the connection with ECHO is enabled, MONIT 
NETGETs the messages sent to it by ECHO, and outputs 
them prefixed by the time they were accepted. See 
figure 6-10. 



THE DEBUG OPTION 

NAM provides debugging options used for program tracing 
and verification. This feature can be turned on and off at 
execution time, and can log supervisory message dialogs and 
data message transactions between NAM and the 
application. 




AAAAAAAAAA 
BBBBBBBBBB 
CCCCCCCCCC 
DDDDDDDDDD 



1111111111 
2222222222 
3333333333 



MON IT'S output 



user typings 



1212121212 
4545454545 



18.05.44 

18.06.12 

16.06.14 

18.06.55 

18.07.01 

18.07.46 

18.08.32 

18.03.33 

18.09.25 

18.09.26 

18.09.51 

18.09.52 

18.11.12 

18.11.54 

18.11.55 

18.12.43 

18.12.45 

18.13.46 

18.13.47 

18.14.14 

18.14.16 



18.05.36 HA = 02000100000020000012 TA 

18.06.06 HA = 01000100000020000012 TA 

18.06.07 HA = 02000100000020000012 TA 

18.06.50 HA = 01000100000020000012 TA 

18.06.51 HA = 02000100000020000012 TA 
18.07.45 HA = 02000200000020000012 TA 
18.08.31 HA = 01000200000020000012 TA 
18.08.31 HA = 02000200000020000012 TA 
18.09.25 HA =01000100000020000012 TA 
18.09.25 HA = 02000100000020000012 TA 
18.09.48 HA = 01000200000020000012 TA 
18.09.48 HA = 02000200000020000012 TA 
18.11.11 HA = 02000300000020000012 TA 
18.11.54 HA = 01000200000020000012 TA 
18.11.54 HA = 02000200000020000012 TA 

18.12.43 HA = 01000300000020000012 TA 

18.12.44 HA = 02000300000020000012 TA 

18.13.45 HA = 01000300000020000012 TA 
18.13.45 HA = 02000300000020000012 TA 

18.14.13 HA = 01000100000020000012 TA 

18.14.14 HA = 02000100000020000012 TA 



The time when 
the message 
was accepted 
by MONIT 



The time the 
message was 
sent by ECHO 



Original ABH 
sent by ECHO 



Figure 6-10. ECHO-MONIT Interaction 
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The system library, NETIO, contains all AIP procedures 
without the debugging option, while system library, NETIOD, 
contains AIP procedures with the debugging options. 

If debugging options are not required, load AIP procedures 
from NETIO. Loading from NETIOD requires additional 
central memory at the control point of the application. 

In order to check if the debugging options are available and 
turn them on or off, the AIP NETDBG routine must be 
called: 

CALL NETDBG (opt^opt^stat) 
where: 

opt. = turns on logging of asynchronous super- 

visory messages (without FC/ACK). 

^ turns off logging of asynchronous super- 

visory messages. 

opt, = turns on logging of data messages 

2 (including FC/ACK) up to a maximum of 

10 words. 

^ turns off logging of data messages. 

stat = indicates debugging options are available 

(AIP procedures were loaded from 
NETIOD). 

^ 1 indicates debugging options are not avail- 

able (AIP procedures were loaded from 
NETIO). 

All debug output is written to the local file ZZZZZDN. Data 
is formatted as display code character strings which can 
later be rewound and copied to the OUTPUT file routed to 
the print queue. Debug output is written to the log file by 
calling NETON, NETOFF, NETDBG and each one of AIP 
input/output routines. NETON and NETOFF calls are logged 
to indicate the start and end of the NAM interface. The 
NETDBG call is logged to indicate the debugging options 
selected. The AIP input/output routines are logged to 
indicate supervisory messages and the data messages 
exchanged between NAM and the application. Table 6-1 
summarizes the output information and the conditions under 
which it is logged. A debug output example is shown in 
figure 6-11. 



TABLE 6-1. OUTPUT INFORMATION AND 
CONDITIONS OF DEBUG OPTIONS 



Routine 
Called 


Information Logged 


Notes 


NETON 


NETON parameters, 


Logged only if 




date and time, routine 


successful 




name and address 


status = 0; refer 
to section 3. 


NETOFF 


Date and time, routine 


An EOR is 




name and address 


written after 
NETOFF call is 
logged. 


NETDBG 


Debugging options 
selected, time, routine 
name and address 




NETGET \ 


Header and routine \ 


Logged only if 


NETGETL 1 


parameters, text area 1 


the call results 


NETGETF ! 


and/or fragmented 1 


in 'the transfer 


NETGTFL ( 


area contents, time, / 


of a message, 


NETPUT I 


routine name and I 


and the appro- 


NETPUTF/ 


address / 


1 priate option 
1 is on. 



THE STATISTICAL OPTION 

Statistical information can be gathered by NAM from the 
local file ZZZZZSN. The statistical option is automatically 
activated when loading from the NETIOD system library. In 
order to check option availability and turn it on or off, the 
user must call NETSTC as follows: 

CALL NETSTC (opt,stat) 

where: 

opt = turns statistical option on. 

= 1 turns statistical option off. 
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p NETON parameters 



AIP 

routine 

called 

Hour 1 



Header area 
address 



Routine 
address 



09.57.38. NcTON ( 7300J 
NSUP AOOR = 17226 MINACN 



Application 
name 



ANAME = TAPPL* 
1 MAXACN = 



Text area 
address 




78/06/05. 



10. Mf .'08. 


NETGETL ( 


27«t6> 


AIM = 


HA = 1733* 


TA * 17335 


TLMAX = 


: 63 


ABT = 3 


ADR = 


ABN = 


ACT 


= 1 STATUS 


= 00000000 


TLC = 


10 



1 630000001*00200 

2 5QD71B<?2DB**800 

3 00000000000010% 
J, 000000000000000 

5 ^o^eoocoooooos 

6 itCB6037587C008«» 

7 OOOFFFFFFFFFFFP 

8 FFFFC00001FFFFP 
g FFFFFFFFFFF8F6P 

10 7C01'i018Al<»8157 



3060 000 
2*153M3 
0000000 
0000000 
2331 23«t 
2313333 
00 00 777 
7777770 
7777777 
3700050 



00 00120001000 
3**55550**000 
0000000000*0* 
0000000000000 
0*30000000003 
335333700020* 
7777777777777 
00 00007777777 
77 7777770 7557 
0061205100527 



X= AP H 
TK109 05 

DD 

SYS58 C 
SK0030* BO 



?!? 



IHMIH 



MSS NO. 



Display code 
characters 
of text area 



* E FJEMEH 



10. l»*. 08. 
ABT = 3 



/ 



NETPUT t 303*) 
ADR = ABU = 



63i»0000010000Cl 



09.22.26. 



N£T0FF . C thbi.) 



HA = 1733ii TA = 17335 

ACT = 1 STATUS - 000 00000 



30 6*00 00 00100000301 



DATE « 76/06/06. 



•-Hexadecimal 
digits of 
text area 



Octal digits of 
text area 



X# 



Header area 
flags, in 
binary digits 



TLC = 



A C» 



MSG NO. 



-Header area 
values 



Figure 6-11. Debug Output Example 
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stat - indicates statistical option is available 

(AIP procedures were loaded from 
NETIOD). 

= 1 indicates statistical option is not available 

(AIP procedures were loaded from 
NETIO). 

The statistical information written to ZZZZZSN is shown in 
figure 6-12. 



Between the STATISTICS GATHERING STARTED and 
TERMINATED messages, if one of the counters overflows, 
the corresponding line of statistical information is written 
to file ZZZZZSN, preceded by the message 



****COUNTER OVERFLOW**** 



and the corresponding counter is reset to 0. See figure 6-13. 



NAM STATISTICS GATHERING TERMINATED 
NETyyy DATE xx/xx/xx TIME xx.xx.xx 

where yyy is either OFF or STC. 



CPU TIME USED: xxxxxx SEC 
FREQUENCY OF PROCEDURE CALLS 



NETCHEK 


xxxxxx 


NETGET 


xxxxxx 


NETGETF 


xxxxxx 


NETGETL 


xxxxxx 


NETGTFL 


xxxxxx 


NETPUT 


xxxxxx 


NETPUTF 


xxxxxx 


NETSETP 


xxxxxx 


NETWAIT 


xxxxxx 



NUMBER OF WORKLIST TRANSFER ATTEMPTS 

SUCCESSFUL xxxxxx 

UNSUCCESSFUL xxxxxx 

NUMBER OF INPUT/OUTPUT BLOCKS 
TRANSFERRED 



INPUT 
INPUT 
INPUT 
INPUT 



ABT=0 
ABT=1 
ABT=2 
ABT=3 



OUTPUT ABT=1 
OUTPUT ABT=2 
OUTPUT ABT=3 

NUMBER OF ERRORS 

LOGICAL ERROR 
NAK-S 



xxxxxx 
xxxxxx 
xxxxxx 
xxxxxx 

xxxxxx 
xxxxxx 
xxxxxx 



xxxxxx 
xxxxxx 



where xxxxxx is a 60-bit signed integer, if the corre- 
sponding line is not printed. 



NAM STATISTICS GATHERING STARTED 
NETON DATE 77/09/27. TIME 04.11.09. 

NAM STATISTICS GATHERING TERMINATED 
NETOFF DATE 77/09/27. TIME 04.11.09. 

CPU TIME USED: 0.311 SEC 

NUMBER OF PROCEDURE CALLS 

NETGTFL 3 

NETPUT 5 

NETPUTF 2 

NUMBER OF WORKLIST TRANSFER ATTEMPTS 

NUMBER OF INPUT/OUTPUT BLOCKS TRANSFERRED 
INPUT ABT=0 3 

OUTPUT ABT=1 4 

OUTPUT ABT=2 1 

NUMBER OF ERRORS 



Figure 6-13. Statistical Option Output Example 



Figure 6-12. NAM Statistic Gathering 
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STANDARD CHARACTER SETS 



OPERATING SYSTEM CHARACTER SETS 



CDC operating systems offer the following variations of a 
basic character set: 



describe character transmissions between an application 
program and the network. The BCD code shown in table A-l 
is a 7-track tape code, while the ASCII code shown is a 
9-track tape code. Network character translation is 
described in the following subsection. 



CDC 63-character set 

CDC 64-character set 

ASCII 63-character set 

ASCII 64-character set 

ASCII 128-character set 

The set in use at a particular installation is specified when 
the operating system is installed or deadstarted. Depending 
on another installation option, the system assumes an input 
deck has been punched either in 026 or 029 mode (regardless 
of the character set in use). 

For card decks read at -local peripherals, alternate keypunch 
modes can be specified by a 26 or 29 punched in columns 79 
and 80 of any 6/7/9 card or 7/8/9 card. The specified mode 
remains in effect through the end of the job unless it is reset 
by specification of the alternate mode on a subsequent 7/8/9 
card or 6/7/9 card. 

For card decks read from remote batch stations through 
RBF, the ability to use the alternate mode selection is 
dependent upon the remote terminal equipment. See Input 
Deck Structure in the RBF reference manual. 

Graphic character representation appearing at a terminal or 
printer depends on the installation character set and the 
terminal type. Characters shown in the CDC Graphic 
column of the standard character set table (table A-l) are 
applicable to BCD terminals; ASCII graphic characters are 
applicable to ASCII terminals. Tables A-l through A-4 are 
provided for the reader's use while coding an application 
program to run under the operating system. They do not 



128-CHARACTER ASCII SET 

Table A-5 contains the 128-character ASCII set supported 
by the Network Access Method. A 96-character subset 
consists of the rightmost six columns; a 64-character subset 
consists of the middle four columns. Note that display code 
equivalents exist for the characters in this 64-character 
subset only. 

While the network supports the 128-character set, terminal 
restrictions might require that output to a device be limited 
to a smaller subset. This is accomplished by replacing the 
control characters in columns and 1 of table A-5 with 
blanks to produce the 96-character subset, and additionally 
replacing the characters in columns 6 and 7 with the 
corresponding characters from columns 4 and 5, respec- 
tively, to produce the 64-character subset. 

Similarly, input from a device may be limited to a smaller 
subset by the device itself because of an inability to produce 
the full 128-character set. A character input from a device 
using a character set other than ASCII is converted to an 
equivalent ASCII character; characters without ASCII 
character equivalents are replaced by the ASCII blank 
character. 

An application can also cause character replacement as 
described for output above as well as the character 
conversion, by requesting display-coded input from the 
network. 

The 7-bit hexadecimal code value for each character 
consists of the character's column number in the table, 
followed by its row number. For example, N is in row E and 



column 4, so its value is 4E 
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TABLE A-l. STANDARD CHARACTER SETS 



Display 
Code 
(octal) 



CDC 



Graphic 



Hollerith 
Punch 
(026) 



External 
BCD 
Code 



ASCII 



Graphic 


Punch 


Code 


Subset 


(029) 


(octal) 


: (colon) t+ 


8-2 


072 


A 


12-1 


101 


B 


12-2 


102 


C 


12-3 


103 


D 


12-4 


104 


E 


12-5 


105 


F 


12-6 


106 


G 


12-7 


107 


H 


12-8 


110 


1 


12-9 


111 


J 


11-1 


112 


K 


11-2 


113 


L 


11-3 


114 


M 


11-4 


115 


N 


11-5 


116 





11-6 


117 


P 


11-7 


120 


Q 


11-8 


121 


R 


11-9 


122 


S 


0-2 


123 


T 


0-3 


124 


U 


0-4 


125 


V 


0-5 


126 


W 


0-6 


127 


X 


0-7 


130 


Y 


08 


131 


Z 


0-9 


132 








060 


1 


1 


061 


2 


2 


062 


3 


3 


063 


4 


4 


064 


5 


5 


065 


6 


6 


066 


7 


7 


067 


8 


8 


070 


9 


9 


071 


+ 


12-8-6 


053 


- 


11 


055 


♦ 


11-8-4 


052 


/ 


0-1 


057 


( 


12-8-5 


050 


) 


11-8-5 


051 


$ 


11-8-3 


044 


= 


8-6 


075 


blank 


no punch 


040 


, (comma) 


0-8-3 


054 


. (period) 


12-8-3 


056 


# 


8-3 


043 


C 


12-8-2 


133 


} 


11-8-2 


135 


%" 


05-4 


045 


" (quote) 


8-7 


042 


(underline) 


0-8-5 
12-8-7 or 11-0 TTT 


137 


I 


041 


& 


12 


046 


' (apostrophe) 


8-5 


047 


? 


0-8-7 
12-8-4 or 12-0 TTT 


077 


< 


074 


> 


0-8-6 


076 


<a> 


8-4 


100 


\ 


0-8-2 


134 


- (circumflex) 


11-8-7 


136 


; (semicolon) 


11-8-6 


073 



oo 1 " 

01 
02 
03 
04 
05 
06 
07 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 
47 
50 
51 
52 
53 
54 
55 
56 
57 
60 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 
74 
75 
76 
77 



(colon) n 
A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 

P 
Q 
R 
S 
T 
U 
V 

w 

X 
Y 

z 



1 

2 
3 

4 
5 
6 

7 
8 
9 

+ 



_L 



blank 
, (comma) 
. (period) 

7 



A 

t 

I 
< 

> 

< 

> 
—I 

(semicolon) 



8-2 

12-1 

12-2 

12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 

11-1 

11-2 

11-3 

11-4 

11-5 

11-6 

11-7 

11-8 

11-9 

0-2 

0-3 

0-4 

0-5 

0-6 

0-7 

0-8 

0-9 



1 

2 

3 

4 

5 

6 

7 

8 

9 

12 

11 

11-8-4 

0-1 

0-8-4 

12-8-4 

11-8-3 

8-3 

no punch 

0-8-3 

12-8-3 

0-8-6 

8-7 

0-8-2 

8-6 

8-4 

0-8-5 

11-0 or 11-8-2 m 

08-7 

11-8-5 

11-8-6 

12-0 or 12-8-2 TTT 

11-8-7 

8-5 

12-8-5 

12-8-6 

12-8-7 



00 
61 
62 
63 
64 
65 
66 
67 
70 
71 
41 
42 
43 
44 
45 
46 
47 
50 
51 
22 
23 
24 
25 
26 
27 
30 
31 
12 
01 
02 
03 
04 
05 
06 
07 
10 
11 
60 
40 
54 
21 
34 
74 
53 
13 
20 
33 
73 
36 
17 
32 
16 
14 
35 
52 
37 
55 
56 
72 
57 
15 
75 
76 
77 



Twelve zero bits at tl j end of a 60-bit word in a zero byte record are an end of record mark rather than 
two colons. 
'In installations using a 63-graphic set, display code 00 has no associated graphic or card code; display 
code 63 is the colon (8-2 punch). The % graphic and related card codes do not exist and translations 
yield a blank (55q). 
'"The alternate Hollerith (026) and ASCII (029) punches are accepted for input only. 
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3C 


I 


7B 


< 


4C 


\ 


CO 


33 








30 


DLE 


10 





F0 


DLE 


10 


73 


> 


> 


3E 


RS 


IE 


> 


6E 


IRS 


IE 


34 


1 


1 


31 


DC1 


11 


1 


F1 


DC1 


11 


74 


< @ 


@ 


40 


' 


60 


@ 


7C 


' 


79 


35 


2 


2 


32 


DC2 


12 


2 


F2 


DC2 


12 


75 


> \ 


\ 


5C 


I 
1 


7C 


\ 


E0 


I 
1 


6A 


36 


3 3 


33 


DC3 


13 


3 


F3 


TM 


13 


76 


^ 


/\ 


5E 


~ 


7E 


— 1 


5F 


~ 


A1 


37 


4 I 4 


34 


DC4 


14 


4 F4 


DC4 


3C 


77 


; 




3B 


ESC 


IB 




5E 


ESC 


27 




NOTES: 








1. The terms uppercase and lowercase apply only to the 
case conversions, and do not necessarily reflect any true 
case. 

2. When translating from Display Code to ASCII/EBCDIC, 
the uppercase equivalent character is taken. 


4. / 
[ 

5. V 
c 

s 
c 


Ml ASCII and EBCDIC codes not listed are translated to 
)isplay Code 55g(SP). 

Vhere two Display Code graphics are shown for a single octal 
ode, the leftmost graphic corresponds to the CDC 64 character 
et, and the rightmost graphic corresponds to the CDC 64- 
haracter ASCII subset. 




3. When translating from ASCII/EBCDIC to Display Code, 
the uppercase and lowercase characters fold together to 
a single Display Code equivalent character. 


6. 1 
i 
f 


n a 63-character set system, the display code for the : graphic 
s 63. The % character does not exist, and translations from 
kSCII/EBCDIG % or ENQ yield blank (55g). 
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TABLE A-5. FULL ASCII CHARACTER SET 

-» 128-Charaeter Set 



96-Character Subset 



64-Character Subset • 












1 



1 





l 
i 


1 




1 



1 


1 
1 



1 
1 

1 


. b? b 








v B . 














b 4 


b 3 
♦ 


b 2 

♦ 


b l 

* 


""^V^ COLUMN 





1 


2 


3 


4 


5 


6 


7 


^k. 


ROW ^"V. 



















NUL 


DLE 


SP 





@ 


P 


\ 


P 













1 


1 


SOH 


DC1 


: 


1 


A 


Q 


a 


q 










1 





2 


STX 


DC 2 


tt 


2 


B 


R 


b 


r 










1 


1 


3 


ETX 


DC3 


# 


3 


C 


S 


c 


s 







1 








4 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 







1 





1 


5 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 







1 


1 





6 


ACK 


SYN 


& 


6 


F 


V 


f 


V 







1 


1 


1 


7 


BEL 


ETB 


/ 


7 


G 


W 


S 


w 















8 


BS 


CAN 


( 


8 


H 


X 


h 


X 












1 


9 


HT 


EM 


) 


9 


I 


Y 


i 


y 









1 





A 


LF 


SUB 


* 


: 


J 


Z 


J 


z 









1 


1 


B 


VT 


ESC 


+ 


» 


K 


[ 


k 


{ 






1 








C 


FF 


FS 


» 


< 


L 


\ 


1 


1 

1 






1 





1 


D 


CR 


GS 


- 


= 


M 


] 


m 


} 






1 


1 





E 


SO 


RS 


. 


> 


N 


^ 


n 


~ 






1 


1 


1 


F 


SI 


US 


/ 


» 


O 








DEL 
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LIST OF KEYWORDS 



B 



1. The following general field names are applicable to all 
supervisory messages: 

PFCSFC Primary and secondary function code 

PFC Primary function code 

EB Error bit 

RB Response bit 

SFC Secondary function 

RC Reason code 

SPMSGO Word of any supervisory message 

SPMSG1 Word 1 of any supervisory message 

SPMSG9 Word 9 of any supervisory message 

2. The following fields are in connection management 
messages: 

CONACN Application connection number 

CONABL Application block limit 

CONHW Hardwired line 

CONDT Device type 

CONORD Device ordinal 

CONTNM Terminal name 

CONANM Name of requesting application 

CONPW Page width 

CONPL Page length 

CONOWT Controlling user's terminal name 

CONPAR First word of parameters passed on 
a CON/REQ 

CONACT Application input character type 

CONALN Application list number 

3. The following fields are in other messages: 
FCACN ACN in all FC messages 
FCABN ABN in FC/ACK 
LSTACN ACN in all LST messages 
LSTALN ALN in LST/SWH 
GTRSTR String in CTRL/DEF 



DCACN ACN in DC/CICT 

ERRMSG Message text in ERR/LGL 

ERRABH ABH in ERR/LGL 

MSGNCH NCHAR in MSG/LOP 

MSGTEX TEXT in MSG/LOP 

SHUTYP Shut down type in SHUT/INSD 

4. The following fields in the application block header are 
for supervisory or nonsupervisory messages: 

ABHABT Application block type 

ABHADR Addressing information 

ABHABN Application block number 

ABHACT Application character type 

ABHIBU Input block uhdeliverable flag 

ABHNFE No format effectors flag 

ABHXPT Transparent bit 

ABHCAN Cancel bit or punch-banner-card 

ABHBIT Parity error or auto-input flag 

ABHTLC Text length in characters 

ABHWORD Whole word of ABH 



5. Control Data defined values of the following symbols 
are available to the application. Release values are 
indicated in parentheses. 

CON PFC for CON messages (63.,) 

LCONRQ Length of CON/REQ message not 

including APARAM (4) 

LCORQR Length of CON/REQ response (1) 

REQ SFC for CON/REQ (00) 

CONREQ PFC and SFC for CON/REQ (6300 16 ) 

LCONAC Length of CON/ACRQ (2) 

ACRQ SFC for CON/ACRQ (02 16 ) 

CONACR PFC and SFC for CON/ACRQ (6302 16 ) 

LCONEN Length of CON/END (2) 

ENDD SFC for CON/END (06 lfi ) 

CONEND PFC and SFC for CON/END (6306 16 ) 
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CB 

CONCB 

LCONCB 

LCTRL 

CTRL 

START 

CTRSTR 

STOPP 

CTRSTP 

STPD 

CTRSTD 

DEFF 

CTRDEF 

LDC 

DC 

CICT 

DCCICT 

LLST 



SFC for CON/CB (05 16 ) 

PFCSFC for CONCB (6305 16 ) 

Length of the CON/CB message 

Length of all the CTRL messages 

PFC for CTRL messages (CI,,) 

SFC for CTRL/START (05 16 ) 

PFC and SFC for CTRL/START (C105 16 ) 

SFC for CTRL/STOP (06 16 ) 

PFC and SFC for CTRL/STOP (C106 16 ) 

SFC for CTRL/STPD 

PFC/SFC for CTRL/STPD 

SFC for CTRL/DEF (C104 lfi ) 

PFC/SFC for CTRL/DEF (C104 16 ) 

Length of DC/CICT (1) 

PFC for DC/CICT (C2 16 ) 

SFC for DC/CICT (00 16 ) 

PFCSFC for DC/CICT (C200 16 ) 

Length of LST messages (1) 



LST 

OFF 

LSTOFF 

ON 

LSTON 

SWH 

LSTSWH 

LMSG 

MSG 

LOP 

MSGLOP 

LSHUT 

SHUT 

INSD 

SHUINS 

LTCH 

TCH 

TCHAR 

TCHTCH 



PFC for LST messages (COjJ 

SFC for LST/OFF (1) 

PFC and SFC for LST/OFF (C001 16 ) 

SFC for LST/ON (0) 

PFC and SFC for LST/ON (C000 16 ) 

SFC for LST/SWH (02 16 ) 

PFC and SFC for LST/SWH (C002 16 ) 

Length of MSG messages (1) 

PFC for MSG (EG" 16 ) 

SFC for MSG/LOP (07 1G ) 

PFC and SFC for MSG/LOP (E007 16 ) 

Length of SHUT messages (1) 

PFC for SHUT messages (42 16 ) 

SFC for SHUT/INSD (06 16 ) 

PFC and SFC for SHUT/INSD (4206 16 ) 

Length of TCH messages (1) 

PFC for TCH (64 I6 ) 

SFC for TCH/TCHAR (00 I6 ) 

PFC and SFC for TCH/TCHAR (6400 lfi ) 
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SUPERVISORY MESSAGES 



NAM TO THE APPLICATION 


APPLICATION TO NAM 




PFC/SFC 


Hex Code 


Meaninq 


PFC/SFC 


Hex Code 


Meaninq 


CON/REQ 


4206 


Request logical 
connection 


CON/ACRQ 


6302 


Application connection 
request 


CON/CB 


6305 


Connection broken 


CON/END 


6306 


End connection 


FC/BRK 
FC/STP 


8300 

8305 


Break 

Suspend data traffic 


MSG/LOP 


E007 


Message to local 
operator 


FC/STRT 


8306 


Resume data traffic 


DC/CICT 


C200 


Change input character 


FC/INIT 
FC/ACK 


8307 
8302 


Logical connection 
initialized 

Block delivered 


FC/RST 


8301 


type 
Reset 


FC/NAK 


8303 


Block not delivered 


CTRL/DEF f 


C104 


Define terminal char- 
acteristics 


FC/INACT 


8304 


Connection inactive 








ERR/LGL 


8401 


Logical error 


LST/OFF 


COOO 


Temporary OFF 


SHUT/INSD 


4206 


Network shutdown 


LST/ON 


C001 


Temporary ON 


TCH/TCHAR 


6400 


Terminal character- 
istics changed 


LST/SWH 


C002 


Switch lists 



* Synchronous SM; all other SMs are asynchronous. 
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CONFIGURATION FILES 



Two files are used by the network host products software in 
establishing, initiating, and operating the network: 

• The network configuration file (NCF) 

• The local configuration file (LCF) 

Both files are direct access, random indexed permanent 
files. 

The NCF contains information that describes the physical 
and logical configuration of the network elements, such as: 

B The host and its connected couplers 

9 The NPUs that are part of the network 



• The physical and logical connections for the host, 
couplers, and NPUs 

The LCF describes those components of the network which 
belong to a host computer, such as: 

• The application program names known to the network 

• The lines between NPUs and terminals 

• The initial terminal characteristics 

These components are described by the Network Definition 
Language (NDL) statements, and are created by the NDL 
Processor. The NDL Processor executes as a batch job 
separately from the network environment. For further 
information, refer to the NDL reference manual. 
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Application 4-1 

name 6-15 

programs 1-2, 2-1 
Application block header 2-2 
Application block limit 4-2 
Application block number 2-3 
Application connection number 2-1, 3-2 
Application interface program 1-1 

subroutines 3-1 
Application list number 3-5, 3-8, 3-10 
Application-to-application 1-2 

communication 6-5 

ECHO-MONIT 6-6 
ASCII 5-1, A-l 



Block 

BLK 2-2 

character type 3-3 
delivery 4-2 
length 3-3 
MSG 2-2,2-3 
type 3-2 



Character type 5-2 
Communications Control Program 1-1 
Communication supervisor 1-1 
Configuration files D-l 
Connection initialized 3-6 
Connection establishment steps 3-3 
CON/ACRQ 2-5,6-5 
CON/CB 2-4,4-1 
CON/END 2-5,4-2 
CON/REQ 2-4, 3-5 



Debug option 6-13 
Device type 5-4 
DC/CICT 5-2 



EASY (see sample program) 
ECHO (see sample program) 
Error bit 2-5, 3-8 
Error handling 4-5 
ERR/LGL 4-6 



Format effectors 5-1 
Flow-control/initialized 3-6 
Fragmented buffer routines 6-1, 6-3 
FC/ACK 2-4,4-2,6-14 
FC/BRK 4-4,4-5 
FC/INIT 2-4, 3-4 
FC/NAK 4-3 
FC/RST 4-3,4-5 
FC/STA 4-3,4-4 



IBUbit 5-6 

Interactive Facility 1-1, 1-2 

Interactive virtual terminal mode 5-1, 5-6 



Keywords 3-8, B-l 



Local connection breakage 4-1 
LST/OFF C-l 
LST/ON C-l 



Memory allocation 6-4 
Message 2-2 

MONITs, (see sample program) 
MSG/LdP 2-5 



NETCHEK 3-1,6-1 

NETDBG 3-1,6-14 

NETGET 3-1,6-1,6-14 

NETGETF 3-1,6-1,6-14 

NETGETL 3-1,6-1,6-14 

NETIO 6-14,6-16 

NETIOD 6-14 

NETOFF 3-1,6-14 

NETON 3-1, 3-7, 6-14 

NETPUT 3-1,6-1,6-14 

NETPUTF 3-1,6-14 

NETSTC 3-1 

NETSTEP 3-1,6-1 

NETWAIT 3-1,3-2 

NetWork 1-1 

Network access 3-1 

Network Access Method 1-1 

Network Interface Program 1-1, 1-2 

Network supervisor 1-1 

Network Validation Facility 1-1 

NFETCH 3-6 

NSTORE 3-6 

NSUP word 3-2, 6-1, 6-6 



Page-waiting 5-3 

Parallel mode 1-2, 3-2, 6-1 , 

Parity 5-3 

Peripheral Interface Program 1-1, 1-2 

PFC/SFC 2-4 

Primary function code 2-4, 3-8 

Protocol 1-1, 2-4 



Reason code 3-8, 4-7 
Remote Batch Facility 
Response bit 2-5, 3-8 



1-1, 1-2 



Header area 6-3, 6-15 

Host 

computer 1-2 
shutdown 4-6 



Sample program 3-4 
EASY 3-7,3-9,6-2 
ECHO 4-6,6-6,6-13 
MONIT 6-6,6-13 
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Secondary function code 2-4, 3-8 
SHUT/INSD 4-5,4-6 
Statistical option 6-14 
Supervisory message 1-2, 2-2 

application to NAM 2-5, C-l 

asynchronous 2-2, 3-2 

basic protocols 2-4 

format 2-5, 2-6 

NAM to application 2-4, C-l 

synchronous 2-2 



TCH/TCHAR 5-5 
Terminal 

characteristics 5-2 

classes 5-4 
Terminal Verification Facility 1-1 
Text area 2-2, 3-3 
Time 3-3 

Transaction Access Facility 1-1 
Transparent mode 5-2, 5-6 

User break keys 4-6 
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